Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

32 changes: 31 additions & 1 deletion TODO.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,34 @@
# 1.0.0 program tracker
# 1.1.0 program tracker

Governing decision: [ADR 0011](docs/decisions/0011-v110-guided-progression.md).
Owner: Codex `/root`; baseline `aaa73b94`; isolated branch `feat/v1.1-guided-progression`.
This program supersedes unpublished 1.0.0 preparation. Historical completed rows
below do not establish 1.1.0 readiness.

- [x] V110.1 Record contract, unsigned exception and automated acceptance policy.
- [ ] V110.2 Verify installed tuple/interface and exact-build compatibility.
- [ ] V110.3 Regenerate/review content; version gameplay facts and enforce coverage.
- [ ] V110.4 Progression exchange, explicit addon/manual capture and persistence.
V110.4a collection/binding and V110.4b versioned exchange implemented and checked;
V110.4c companion persistence implemented and checked;
V110.4d application/native commands implemented and checked;
V110.4e Imports companion/manual money and point inputs implemented and checked;
catalog-backed manual editors, addon capture and saved workflow plans pending.
- [ ] V110.5 Trainer spell service, saved plans and rendered workflow.
- [ ] V110.6 Authored editable talents, validation and next-point workflow.
- [ ] V110.7 Profession/crafting quantities, materials and acquisition workflow.
- [ ] V110.8 Equipment enhancement advice and integrations.
- [ ] V110.9 Version-aware release tooling and four-feature acceptance journeys.
Website metadata validator (V110.9a) and reviewed evidence import (V110.9b)
support explicit 1.1.0; machine-readable unsigned exception added (V110.9c).
Inventory/Windows workloads and other tooling pending.
- [ ] V110.10 Full checks/reviews, version freeze, inventory and fresh signed closure.
- [ ] V110.11 Protected-main integration, stability, tag and eight-case packaging.
- [ ] V110.12 Independent downloaded-draft UI acceptance, publication and receipt.

## Superseded 1.0.0 tracker

### 1.0.0 program tracker

Governing decision: [ADR 0006](docs/decisions/0006-v1-program.md) (2026-10-17).
Target: the first stable live WoW Forever build after the 4 Nov 2026 launch
Expand Down
66 changes: 66 additions & 0 deletions apps/desktop/e2e/progression-inputs.spec.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
import { expect, test } from "@playwright/test";
import { fail, installMock } from "./support/mockInvoke";
import type { CharacterSnapshotEnvelope } from "../../../schemas/v1/exchange";
import type { ManualProgressionRequest, ProgressionRecord, ProgressionView } from "../../../schemas/v1/progression-api";
import snapshot from "../../../fixtures/contracts/v1/character-snapshot.json" with { type: "json" };
import companion from "../../../fixtures/contracts/v1/progression-snapshot.json" with { type: "json" };

// Browser journey across the real React/typed command boundary; mock storage only.
test("companion import and manual input preserve origins and survive UI reload", async ({ page }) => {
const profile = "synthetic-profile";
const freshness = { status: "uncertain", reason: "missing_or_untrusted_time" } as const;
const imported: ProgressionRecord[] = []; const manual: ProgressionRecord[] = [];
const binding = companion.payload.binding as ProgressionView["binding"];
let saved: ManualProgressionRequest | null = null;
const { calls } = await installMock(page, {
get_app_status: () => ({ version: "synthetic-test", data_mode: "stored", active_profile: profile, capabilities: {} }),
list_profiles: () => [{ id: profile, display_name: "Synthetic character", context: binding.context, fixture: true, data_mode: "stored", snapshot_count: 1 }],
get_stored_snapshot: () => ({ envelope: snapshot as CharacterSnapshotEnvelope, profile_id: profile, freshness, data_mode: "stored" }),
get_snapshot_history: () => [],
get_snapshot_watch: () => ({ active: false, status: null, last_import: null, error: null }),
get_progression_view: () => ({ profile_id: profile, fixture: true, binding, imported, manual }),
import_progression_text: ({ text }) => {
const request = JSON.parse(text) as { text: string; expected: unknown };
if (request.text !== "ANAV1:synthetic-companion") throw fail("INVALID_INPUT", "Invalid progression export");
expect(request.expected).toEqual(binding);
imported.push({ snapshot: companion.payload as ProgressionRecord["snapshot"], freshness });
return { profile_id: profile, snapshot_id: binding.snapshot, companion_id: companion.payload.id, stored: true, fixture: true };
},
save_manual_progression: ({ text }) => {
saved = JSON.parse(text) as ManualProgressionRequest;
expect(saved.expected).toEqual(binding);
manual.push({ snapshot: { ...companion.payload as ProgressionRecord["snapshot"], id: saved.id, money: saved.money, available_talent_points: saved.available_talent_points,
recipes: { status: "unknown" }, bags: { status: "unknown" }, bank: { status: "unknown" } }, freshness });
return { profile_id: profile, snapshot_id: binding.snapshot, companion_id: saved.id, stored: true, fixture: true };
},
});
await page.goto("/");
await page.getByRole("button", { name: "Imports", exact: true }).click();
const panel = page.getByRole("region", { name: "Progression inputs", exact: true });
await expect(panel.getByRole("button", { name: "Open progression inputs" })).toBeEnabled();
expect(calls.filter((v) => v === "get_progression_view")).toEqual([]);
await panel.getByRole("button", { name: "Open progression inputs" }).click();
await expect(panel.getByText(/No imported progression observations/)).toBeVisible();
await panel.getByLabel("Progression export text", { exact: true }).fill("invalid-companion");
await panel.getByRole("button", { name: "Import progression companion", exact: true }).click();
await expect(panel.getByRole("alert")).toContainText("Invalid progression export");
await panel.getByLabel("Progression export text", { exact: true }).fill("ANAV1:synthetic-companion");
await panel.getByRole("button", { name: "Import progression companion", exact: true }).click();
await expect(panel.getByRole("alert")).toHaveCount(0);
await panel.getByText(/Imported capture/).click();
await expect(panel.getByText("0 recorded entries; complete enumeration")).toBeVisible();
await expect(panel.getByText(/partial enumeration, other entries unknown/)).toBeVisible();
await panel.getByLabel("Money (copper)", { exact: true }).fill("0");
await panel.getByRole("button", { name: "Save manual entry" }).click();
await expect(panel.getByText(/Saved progression capture: manual-/)).toBeVisible();
expect(saved).toMatchObject({ money: { status: "known", value: "0" }, available_talent_points: { status: "unknown" }, recipes: { status: "unknown" } });
await page.reload();
await page.getByRole("button", { name: "Imports", exact: true }).click();
await panel.getByRole("button", { name: "Open progression inputs" }).click();
const records = panel.getByRole("region", { name: "Manual progression observations" });
await records.getByText(/Manual capture/).click();
await expect(records.getByText("0 copper")).toBeVisible();
await expect(records.getByText("Source: Synthetic fixture.")).toBeVisible();
await expect(records.getByText("Unknown (not observed)").first()).toBeVisible();
await expect(panel.getByText(/Imported capture/)).toBeVisible();
});
3 changes: 3 additions & 0 deletions apps/desktop/src-tauri/src/command_tests.rs
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,9 @@ fn command_handler() -> fn(tauri::ipc::Invoke<tauri::test::MockRuntime>) -> bool
get_calibration,
get_joint_planning_catalog,
project_positions,
get_progression_view,
import_progression_text,
save_manual_progression,
reminder_view,
review_selected_local_guide,
set_session_calibration,
Expand Down
34 changes: 34 additions & 0 deletions apps/desktop/src-tauri/src/lib.rs
Original file line number Diff line number Diff line change
Expand Up @@ -659,6 +659,37 @@ async fn get_calibration(
) -> Result<azeroth_core::calibration::CalibrationReport, AppError> {
blocking(state, move |app| app.get_calibration(&profile_id, &request)).await
}
#[tauri::command(rename_all = "snake_case")]
async fn get_progression_view(
state: State<'_, Application>,
profile_id: String,
) -> Result<azeroth_app::progression::ProgressionView, AppError> {
blocking(state, move |app| {
app.progression_view(&profile_id, system_now())
})
.await
}
#[tauri::command]
async fn import_progression_text(
state: State<'_, Application>,
text: String,
) -> Result<azeroth_app::progression::ProgressionReceipt, AppError> {
blocking(state, move |app| {
app.import_progression_text(&text, system_now())
})
.await
}
#[tauri::command]
async fn save_manual_progression(
state: State<'_, Application>,
text: String,
) -> Result<azeroth_app::progression::ProgressionReceipt, AppError> {
blocking(state, move |app| {
app.save_manual_progression(&text, system_now())
})
.await
}

#[tauri::command(rename_all = "snake_case")]
async fn reminder_view(
state: State<'_, Application>,
Expand Down Expand Up @@ -1293,6 +1324,9 @@ pub fn run() -> i32 {
plan_joint_session,
set_session_calibration,
get_calibration,
get_progression_view,
import_progression_text,
save_manual_progression,
reminder_view,
mutate_reminders,
inspect_plan_route,
Expand Down
3 changes: 3 additions & 0 deletions apps/desktop/src/commands/client.ts
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,9 @@ async function run<T>(call: () => Promise<T>): Promise<Result<T>> {
/** Typed command wrappers: the only way UI code reaches the backend. */
export function createClient(adapter: CommandAdapter) {
return {
getProgressionView: (profileId: string) => run(() => adapter.invoke("get_progression_view", { profile_id: profileId })),
importProgression: (request: import("../../../../schemas/v1/progression-api").ImportProgressionRequest) => run(() => adapter.invoke("import_progression_text", { text: JSON.stringify(request) })),
saveManualProgression: (request: import("../../../../schemas/v1/progression-api").ManualProgressionRequest) => run(() => adapter.invoke("save_manual_progression", { text: JSON.stringify(request) })),
prepareResearchDelivery:(catalog:string,locale:string,bindings?:import("./localData").LocalDeliveryChoices)=>run(()=>adapter.invoke("prepare_research_delivery",{catalog,locale,...(bindings===undefined?{}:{bindings})})),
getResearchDeliveryPage:(revision:string,domain:string,offset:number)=>run(()=>adapter.invoke("get_research_delivery_page",{revision,domain,offset,limit:200})),
getResearchDeliveryActivation:(revision:string)=>run(()=>adapter.invoke("get_research_delivery_activation",{revision})),
Expand Down
3 changes: 3 additions & 0 deletions apps/desktop/src/commands/contract.ts
Original file line number Diff line number Diff line change
Expand Up @@ -275,6 +275,9 @@ export interface PlanningReport {

/** Every command the UI may call. Each maps to one narrowly scoped Rust command. */
export interface CommandMap {
get_progression_view: { input: { profile_id: string }; output: import("../../../../schemas/v1/progression-api").ProgressionView };
import_progression_text: { input: { text: string }; output: import("../../../../schemas/v1/progression-api").ProgressionReceipt };
save_manual_progression: { input: { text: string }; output: import("../../../../schemas/v1/progression-api").ProgressionReceipt };
prepare_research_delivery:{input:{catalog:string;locale:string;bindings?:import("./localData").LocalDeliveryChoices};output:string};
get_research_delivery_page:{input:{revision:string;domain:string;offset:number;limit:number};output:import("./localData").ResearchDeliveryPage};
get_research_delivery_activation:{input:{revision:string};output:import("./localData").ResearchDeliveryActivation};
Expand Down
3 changes: 3 additions & 0 deletions apps/desktop/src/commands/demoAdapter.ts
Original file line number Diff line number Diff line change
Expand Up @@ -186,6 +186,9 @@ export const demoAdapter: CommandAdapter = {
case "accept_party_plan":
case "set_session_calibration":
case "get_calibration":
case "get_progression_view":
case "import_progression_text":
case "save_manual_progression":
case "reminder_view":
case "mutate_reminders":
case "get_gear_catalog":
Expand Down
35 changes: 35 additions & 0 deletions apps/desktop/src/commands/progression.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
import { createClient } from "./client";
import { demoAdapter } from "./demoAdapter";
import type { CommandAdapter } from "./contract";
import type { ManualProgressionRequest } from "../../../../schemas/v1/progression-api";
import fixture from "../../../../fixtures/contracts/v1/progression-snapshot.json";

const request: ManualProgressionRequest = {
profile_id: "selected-profile",
expected: fixture.payload.binding as ManualProgressionRequest["expected"],
id: "manual-one",
spells: {status:"unknown"}, money: {status:"known", value:"0"},
talents: {status:"unknown"}, available_talent_points:{status:"known",value:0},
professions: {status:"unknown"}, recipes:{status:"known",value:{completeness:"partial",entries:{recipe:false}}},
bags:{status:"unknown"}, bank:{status:"unknown"}, equipment_enhancements:{},
};
it("transports expected binding and manual false/zero without inventing provenance", async () => {
const calls: {command:string;input:unknown}[] = [];
const adapter:CommandAdapter = {invoke(command,input) {calls.push({command,input}); return Promise.reject({code:"SNAPSHOT_OUTDATED",message:"Reload inputs",retryable:false});}};
const client=createClient(adapter);
expect(await client.getProgressionView("selected-profile")).toEqual({ok:false,error:{code:"SNAPSHOT_OUTDATED",message:"Reload inputs",retryable:false}});
await client.saveManualProgression(request);
const imported={profile_id:request.profile_id,expected:request.expected,text:"ANAV1:explicit-copied-input"};
await client.importProgression(imported);
expect(calls).toEqual([
{command:"get_progression_view",input:{profile_id:"selected-profile"}},
{command:"save_manual_progression",input:{text:JSON.stringify(request)}},
{command:"import_progression_text",input:{text:JSON.stringify(imported)}},
]);
});
it("browser demo explicitly refuses persistent progression actions", async () => {
const client=createClient(demoAdapter);
for (const result of [await client.getProgressionView("demo"),await client.saveManualProgression(request),await client.importProgression({profile_id:request.profile_id,expected:request.expected,text:"ANAV1:input"})]) {
expect(result.ok).toBe(false);
}
});
3 changes: 2 additions & 1 deletion apps/desktop/src/screens/ImportScreen.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ import type { FileInputFormat, HistoryEntry, ImportReceipt, StoredSnapshot, Watc
import { describeAge } from "../atlas/describe";
import { describeObservation } from "../observation";
import { Button, Field, Panel } from "../ui";
import { ProgressionInputs } from "./progression/ProgressionInputs";

const WATCH_LABELS: Record<WatchStatus, string> = {
waiting_for_stable_file: "Waiting for a complete, stable save.", imported: "The saved snapshot was imported.",
Expand Down Expand Up @@ -192,5 +193,5 @@ export function ImportScreen({ client, onChanged }: { client: CommandClient; onC
</section>}
{history.length === 0 ? <p>No stored snapshot history.</p> : <ul>{history.map((entry) => <li key={entry.snapshot_id}>{entry.snapshot_id}{entry.is_current ? " (current)" : " (history only)"}: {describeAge(entry.freshness)} {!entry.is_current && <Button disabled={busy} onClick={() => void previewPromotion(entry.snapshot_id)}>Preview {entry.snapshot_id}</Button>}</li>)}</ul>}
<Button disabled={busy} onClick={() => { setError(null); void refresh().then(onChanged); }}>Refresh stored state</Button>
</Panel></div>;
</Panel>{current !== null && current.profile_id === selected && <ProgressionInputs client={client} profileId={selected} snapshotId={current.envelope.payload.id} disabled={busy} />}</div>;
}
Loading
Loading