target-revenue/examples/pilot-candidates/README.md
tegwick 6eec4f6634 Apply Development Effort Calculator to real pilot candidates (WP-0010-T03)
Adds since/until date-range scoping to cluster_commit_hours() and
workplan_task_counts() (threaded through calculate_target_basis()),
needed whenever a candidate is one bounded workplan within a repo
whose overall history spans much more (net-kingdom, railiance-apps)
rather than the whole repo being the candidate (vergabe-teilnahme,
info-tech-canon).

Fixes a real bug found along the way: workplan_task_counts() only
scanned the top level of workplans/, missing net-kingdom's
workplans/archived/ convention entirely - silently reported zero
finished workplans for NK-WP-0002, which lives there. Fixed to scan
recursively; added a regression test.

Updates all three draft pilot-candidate manifests with calculator-
derived target_basis/initial_target values, replacing the hand-picked
placeholders:
  net-kingdom-local-identity:      200,000 -> 10,000 EUR (floor + sanity warnings)
  railiance-vergabe-teilnahme:   3,500,000 -> 648,800 EUR (no warnings)
  info-tech-canon-service-surface: 2,500,000 -> 141,800 EUR (sanity warning)

history/260730-EffortCalculator-CandidateApplication.md records full
derivation, warnings, and the judgment calls made explicit rather than
silently picked (date-scoping windows; measuring vergabe-teilnahme's
own repo rather than railiance-apps' deployment-only wiring, with both
figures shown). Still draft/non-binding - WP-0008-T05 unaffected.

5 new tests (20 -> now covering since/until scoping and the
archived-subdirectory fix). Full suite: 84 passing offline.
2026-07-30 13:29:06 +02:00

49 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Pilot candidate Phase Manifests — DRAFT, NOT DECLARED
These manifests are **draft, non-binding worked examples**
(`workplans/TREV-WP-0008-governance-and-pilot-rollout.md` T03), following
the pattern established by `examples/phase-001/`. They are structurally
valid and conformance-tested exactly like `examples/phase-001/`, but:
- **No Commercial Entitlement is for sale under either manifest.**
- **No Development Credit is being tracked for either candidate.**
- **Neither repo's actual License header has been changed to TRSL.**
- `phase.id` uses a `draft-` prefix specifically so it cannot be confused
with a real, declared Phase.
Built from the two candidates identified with a defensible rationale in
`specs/PilotPhaseCandidateSurvey.md` (T02) — `coulomb-loop` and
`helix-forge` produced no defensible candidate at survey time and are
not represented here.
**`info-tech-canon` (2026-07-29):** the maintainer chose `info-tech-canon`
as the actual first repo to build up the practical Phase-declaration
routine on, explicitly as a **dry run, not a go-live decision**
(confirmed directly, not assumed) — see
`specs/PilotPhaseCandidateSurvey.md` §5 for the candidate rationale. This
repo was outside the original four product lines T02 surveyed; its
candidate was added afterward as this specific, real routine-building
exercise, not a T02 survey gap.
**Nothing here is authorized to go live.** That remains gated behind
`workplans/TREV-WP-0008-governance-and-pilot-rollout.md` T05, regardless
of how complete or plausible these examples look — including
`info-tech-canon`, which was explicitly confirmed as dry-run-only.
| Directory | Product line | Candidate deliverable | Indicative Target Multiple |
|---|---|---|---|
| `net-kingdom-local-identity/` | `net-kingdom` | `NK-WP-0002` Local Identity | Incremental (10x) |
| `railiance-vergabe-teilnahme/` | `railiance-*` (`railiance-apps`) | `vergabe-teilnahme` (`RAILIANCE-WP-0002`/`-0014`) | Product-defining (100x) |
| `info-tech-canon-service-surface/` | `info-tech-canon` | Cumulative service surface, `ITC-WP-0001``ITC-WP-0012` | Product-defining (100x) |
**`target_basis`/`initial_target` figures (updated 2026-07-30):** all
three now use `target_revenue.effort_calculator`-derived values
(`workplans/TREV-WP-0010-development-effort-calculator.md` T03), not the
originally hand-picked illustrative placeholders. Full derivation,
warnings, and the judgment calls involved (date-scoping, and which of two
repos to measure for `railiance-vergabe-teilnahme`) are in
`history/260730-EffortCalculator-CandidateApplication.md`. Two of the
three carry explicit calculator warnings recommending a manual override
before any real use — these are still draft, non-binding figures, not a
settled costing proposal. See `specs/PilotPhaseCandidateSurvey.md` for
the underlying candidate rationale (unaffected by this figure update).