docs: standardize delegated task cost reports

[IAnMove]

Summary

• document a lightweight cost report for delegated tasks and pull requests
• require provider-reported LLM usage, retries, media counts and elapsed time when available
• distinguish simulated tests (zero external LLM tokens) from live provider checks

Validation

• git diff --check
• documentation-only change; no runtime or launcher files changed

Coste de la tarea

• Tests simulados: 0 tokens externos
• Tests reales: N/A
• Llamadas LLM externas: 0
• Tokens de prompt/respuesta/total: N/A
• Generaciones de medios: 0
• Tiempo transcurrido: menos de 1 minuto
• Proveedores/modelos: N/A

---

Note

Low Risk
Documentation-only change to contributor guidelines; no application code, launcher, or runtime behavior is modified.

Overview
Introduces a documentation-only convention so delegated coding tasks and pull requests disclose external LLM and media usage without adding telemetry or billing.

CONTRIBUTING now requires a short cost report in every PR description (or final handoff), with N/A when tools do not expose usage and explicit rules that unit/simulated E2E tests count as 0 external LLM tokens while live Wizard/LLM checks must use provider-reported prompt, completion, and total tokens when available, plus media generation counts and elapsed time.

A new docs/development/TASK_COST_REPORT.md defines the canonical Spanish template (## Coste de la tarea), counting rules (retries in totals, separate media vs text, optional copy from HocusPocus task metadata), and states this is a reporting convention with no runtime or network impact.

^{Reviewed by Cursor Bugbot for commit a9754d9. Configure here.}

[github-actions]

PR Review — Loreframe Studio

Risk: low
Scope: 2 file(s); +63/-0; docs

Automated review from scripts/analyze_pr.py. This is a heuristic pass (no LLM) so humans still own the merge decision.

Findings

• No heuristic issues. Still run the CI checklist below.

Changed files

• added: docs/development/TASK_COST_REPORT.md
• modified: CONTRIBUTING.md

CONTRIBUTING checklist

• python scripts/verify_clean_repo.py
• python -m compileall -q app/services app/launch.py scripts
• cd ui && npm run build if the UI changed
• No weights, CivitAI sidecars, or generated guides
• Stays local-first (no required accounts / telemetry)

Posted by the repo PR review workflow. Re-runs on each push to the PR.

[github-actions]

Code health

Quality score: 49.1/100

Higher is better. The score is a trend dashboard; the independent ratchet below remains the CI gate.

Component	Weight	Current	Change
Cyclomatic health	45%	52.3	+0.0
File concentration	25%	54.0	+0.0
Oversized-file debt	20%	29.2	+0.0
Modularity	10%	61.9	+0.0

Change vs PR base: +0.0 points.

Metric	Value
Production LOC	239,699
Production files	525
Test LOC	68,018
Functions measured	15,000
Functions complexity ≥ 15	779
Maximum complexity	667

Markdown, JSON catalogs and tests are out of this table. Only app/ runtime + ui/src TS/JS count.

Most complex functions

Complexity	Where
667	app/wgp.py:7157 generate_video
374	ui/src/stores/useStore.ts:3952 Async method 'startGeneration'
355	app/_launch_runtime.py:23257 _run_generation
308	app/wgp.py:12274 generate_video_tab
271	ui/src/components/Sidebar/SceneAnimatorPanel.tsx:474 Function 'SceneAnimatorPanel'
266	ui/src/stores/useStore.ts:8494 Async method 'loadSettingsFromOutput'
258	app/services/director/planners/short_film.py:3433 ShortFilmPlanner._plan_story_driven
248	app/services/director_pipeline.py:13735 _run_video_generation
245	app/services/director_pipeline.py:7860 _run_pipeline
243	ui/src/features/agent/agentActions.ts:1105 Function 'parseAction'
226	app/services/director_pipeline.py:6689 update_comic_preview
225	ui/src/features/agent/agentActions.ts:2755 Async function 'executeAgentActions'

Trend vs baseline

Metric	Δ
Production LOC	+6,034
Test LOC	+4,204
Functions ≥ 15	+5
Maximum complexity	+0

Warnings

• production LOC increased by +6,034
• functions at complexity >= 15 increased by +5
• complexity hotspot ui/src/stores/useStore.ts rose 373 -> 374
• complexity hotspot ui/src/features/agent/agentActions.ts rose 241 -> 243
• complexity hotspot ui/src/components/Sidebar/InputsPanel.tsx rose 157 -> 162
• complexity hotspot ui/src/components/MainContent/MediaFeedItem.tsx rose 120 -> 122
• complexity hotspot ui/src/features/comics/ComicEditorPanel.tsx rose 101 -> 103
• complexity hotspot ui/src/components/Sidebar/PromptInput.tsx rose 68 -> 70
• complexity hotspot ui/src/features/series/SeriesSetupPanel.tsx rose 58 -> 62
• complexity hotspot app/services/model3d_service.py rose 51 -> 54
• complexity hotspot ui/src/features/series/actions.ts rose 47 -> 50
• complexity hotspot ui/src/features/comics/generateArtwork.ts rose 42 -> 44
• complexity hotspot ui/src/components/MainContent/TabFilter.tsx rose 19 -> 23
• complexity hotspot ui/src/features/agent/AgentAssistantPanel.tsx rose 19 -> 23
• complexity hotspot ui/src/features/projects/openProject.ts rose 21 -> 22
• complexity hotspot app/services/story_library.py rose 16 -> 19
• complexity hotspot ui/src/components/Sidebar/ControlVideoSection.tsx rose 15 -> 17
• hotspot app/services/director_pipeline.py increased by +186 lines
• hotspot ui/src/features/agent/agentActions.ts increased by +64 lines
• hotspot ui/src/components/Sidebar/SceneAnimatorPanel.tsx increased by +6 lines
• hotspot ui/src/features/video-editor/VideoEditorPanel.tsx increased by +27 lines
• hotspot ui/src/features/comics/ComicWorkflowPanels.tsx increased by +6 lines
• hotspot ui/src/features/comics/ComicEditorPanel.tsx increased by +45 lines
• hotspot ui/src/types/index.ts increased by +3 lines
• hotspot ui/src/features/stories/actions.ts increased by +71 lines
• hotspot app/services/series_library.py increased by +36 lines
• hotspot app/services/model3d_service.py increased by +58 lines
• hotspot ui/src/components/Sidebar/InputsPanel.tsx increased by +32 lines
• hotspot ui/src/components/DirectorDashboard/DirectorDashboard.tsx increased by +17 lines
• hotspot ui/src/features/agent/capabilityRegistry.ts increased by +67 lines
• hotspot ui/src/features/agent/applicationAdapters.ts increased by +30 lines

Ratchet passed.