HELLENISTIC_FREE_ENHANCED_WORKSPACE_PRODUCT_PLAN - TheDaniel166/moira GitHub Wiki
Hellenistic Free, Enhanced, and Workspace Product Plan
Status: Archived pre-implementation product proposal. The six engine gates are complete; all website-tier inventories and promises below require a fresh audit of the active website checkout before implementation.
Engine correction (2026-07-25). This proposal does not override the admitted engine boundary. Decennials currently ends at L2 and now preserves an explicit 360-day distribution coordinate plus elapsed-Julian-day projection receipt; it does not claim civil-month anniversaries. The Gundel/Harley Hermetic name-and-face catalog is reconstructed, but its lookup geometry and all Hermetic product transport are closed exclusions. They are not work items in this product plan.
Release posture: The six-gate engine contract shipped in
moira-astro 6.0.0; the additive dated monthly-profection contract is the
6.1.0 release-candidate delta. Package and REST closure are recorded in
hellenistic_completion/HELLENISTIC_ENGINE_GATES_2026-07.md; hosted website
entitlement work remains separate.
Product constitution
- The MIT package and self-hosted REST server expose every admitted computation without commercial entitlement code.
- The hosted ladder is
Free < Enhanced < Urania Workspace; Workspace inherits Enhanced. Reuse the existing centralized server-side entitlement model. - A subscription buys workflow, persistence, composition, operational scale, and practitioner controls. It does not buy hidden doctrine, sources, failure reasons, or a more favorable result.
- Every displayed result identifies its lineage, source, selector/policy,
engine version, kernel, time/location semantics, derivation, warnings, and
not_evaluablereasons where applicable. - Hellenistic, Hermetic, Persian/Medieval, and later Traditional material remain visibly distinct. "Traditional" may be an umbrella navigation category, not a license to collapse lineages.
- Source-owned quantities such as admitted dignity weights remain available as their named doctrinal objects. Moira does not manufacture a universal strength, luck, fate, auspiciousness, or confidence score from them.
- Timelines juxtapose separately named techniques. They do not silently merge techniques into a prediction or promised outcome.
- Electional work remains bounded and evidence-bearing: inspect a supplied moment, compare a finite candidate set, or scan a finite interval under named constraints. There is no universal "best date" product.
The commercial principle is: computation stays open; hosted continuity, synthesis, and professional workflow may be paid.
Market finding
The free-market floor is already high:
- Astro-Seek provides a wide set of free traditional calculators, including profections, Zodiacal Releasing, lots, primary directions, distributions, Firdaria, and Decennials. Its principal weakness is fragmentation across separate calculators.
- Astro.com keeps broad core calculation available without trying to make every specialist method one integrated workflow; paid products emphasize storage and publication.
- Astro Gold offers free natal/transit charts and interpretations, then charges for its broader feature set: $7.99 monthly, $39.99 annually, or a $69.99 lifetime unlock on iOS at the time of research.
- Solar Fire V9 is a $360 practitioner desktop product. Its paid value is integration: saved chart files, extensive customization, primary directions, profections, dynamic hit lists, electional searches, calendars, reports, and export.
- Traditional-Astrology.com offers a real free traditional reading and charges a one-time $20 for source-cited synthesis and PDF delivery.
- Astrolium currently advertises a free foundation and paid personal/practitioner/studio workflow at approximately $11/$29/$79 monthly. The higher tiers sell clients, scanners, history, reports, API access, alerts, and team workflow. Its pricing and Hellenistic feature pages are not fully consistent about which timing tools belong to which tier, so they are directional evidence rather than a contract model.
Therefore Moira Free cannot be a token sect badge or one locked profection result. Moira's opportunity is an integrated, inspectable method: competitors often provide either disconnected calculators or opaque synthesis. Enhanced should sell personal continuity. Workspace should sell repeatable practitioner work, not superior astrological truth.
Prices and advertised capabilities above were checked on 2026-07-21. They are market observations, not independent validation of competitors' calculations.
Lineage boundary
Hellenistic-labelled product
The current admitted basis includes:
- Whole Sign houses and whole-sign aspects, including direction and overcoming.
- Sect, sect light, hayz, halb, planetary joys, oriental/occidental condition, and besieging.
- Classical essential dignity components, receptions, and source-owned condition vessels.
- Dorothean triplicity under the single admitted
DOROTHEAN_PINGREE_1976doctrine. - Egyptian, Ptolemaic, and Chaldean day/night bounds, with the selector shown.
- Chaldean faces; Hermetic decans only when explicitly labelled Hermetic.
- Classical lots with formula, sect reversal, dependency, and condition truth.
- Annual and monthly profections.
- Zodiacal Releasing and Decennials under their admitted policies.
- Specifically identified Dorothean electional rules.
- Specifically identified Ptolemaic branches within the broader primary-directions subsystem.
Traditional umbrella, not Hellenistic
These may appear in adjacent Traditional workflows but must retain their actual lineage:
- Firdaria and its Bonatti variant: Persian/Medieval.
- Sahl matter and Moon-condition profiles: Medieval Arabic.
- Lord of the Orb, Lord of the Turn, Almuten Figuris, and the current hyleg/alcocoden candidate: Arabic/Medieval lineages.
- Ramesey Moon conditions and Lilly perfection: Early Modern.
- Placidian, Morinus, Regiomontanus, topocentric, and other later primary-direction presets.
The website currently calls Firdaria Hellenistic in
client/src/docs-content/timing-timelords.md; that copy must be corrected before
launch. The package audit also overstates triplicity doctrine support in
wiki/07_audit/FEATURE_AUDIT_2026.md; live code admits only the Dorothean
Pingree doctrine.
Current product truth
Open package and self-hosted REST
The engine already has broad Hellenistic computation. Registered REST includes:
- Chart/houses and the Western chart-profile bundle.
- Six dignity/condition routes.
- Seven lots routes.
- Three triplicity routes.
- Seven bounds routes.
- Four admitted direct Decanates routes; no Hermetic-decan route is exposed.
- Three profection, six Decennials, and five Zodiacal Releasing routes.
- Four source-scoped Dorotheus electional routes.
- Eight mixed-lineage primary-directions routes.
Firdaria has five additional routes but belongs to the Persian/Medieval lane.
Website Free today
Free already provides a public natal calculator, Whole Sign among its free house systems, five Ptolemaic aspects, public planetary hours, ten saved charts for a Free account, and the existing bounded transit experience. It does not yet have a dedicated Hellenistic essentials panel.
Website Enhanced today
Enhanced already contractually owns the website's advanced single-chart layers: dignities, a curated ten-lot set, Behenian stars, midpoints, declination, lunar mansions, antiscia, and chart-aware layer interpretations. It also owns unlimited hosted chart storage and wider personal forecasting. These should not be moved up to Workspace.
The curated lots are Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis, Marriage, Children, and Substance. Existing copy calling this a "28-lot shortlist" is stale.
No hosted website route or interface currently exposes annual profections, Decennials, Firdaria, or Zodiacal Releasing.
Urania Workspace today
Workspace already supplies the correct professional substrate:
- Explicit dignity, bounds, face, solar-condition, sect, and accidental-policy controls.
- Full lots search, tradition filters, formulas, reversal truth, dependencies, conditions, and networks.
- Evidence-rich planet and lot inspectors.
- A substantial primary-directions workbench with spatial/reduction presets, time keys, arcs, profiles, networks, and speculum.
- Progressions, transits, returns, imports, chart-library sync, persistent chart conversation, and research memory.
The Hellenistic feature should extend this environment rather than create a second practitioner application.
Recommended tier matrix
| Capability | MIT package and self-hosted REST | Website Free | Website Enhanced ($9/$99) | Urania Workspace ($19/$190) |
|---|---|---|---|---|
| Admitted atomic computations | Complete | Curated compositions | Same engine | Same engine |
| Sources, lineage, selectors, failure reasons | Complete | Always visible | Always visible | Always visible plus audit receipts |
| Whole Sign natal chart and Ptolemaic aspects | Complete | Full | Full | Full |
| Sect and sect light | Complete | Full | Full | Full |
| Planetary condition | Complete | Concise source-visible snapshot; no synthetic overall score | Full single-chart dignity/condition dossier and receptions | Same plus policy lab, networks, comparison, and saved audit profiles |
| Triplicity/bounds/faces | Complete | Current assignments under named website defaults | Full evidence and admitted selectors for personal study | Side-by-side policy inspection and reusable research profiles |
| Lots | Complete catalog | Fortune, Spirit, Eros, and Necessity with formulas/reversal truth | Existing curated ten-lot set, saved comparisons | Full catalog, filters, dependencies, conditions, and networks |
| Annual profection | Complete | Current year, lord, activated house, and source-visible derivation | Full annual/monthly schedule, arbitrary-date lookup, saved timeline | Batch generation and case comparison |
| Zodiacal Releasing | Complete | Current Fortune or Spirit L1/L2 and next transition | Full admitted timelines, Fortune/Spirit comparison, saved history and alerts; no L3/L4 promise without a separate gate | Multi-lot case comparison, batch work, overlays, and policy audit |
| Decennials | L1/L2 core with explicit distribution/projection receipt | Current L1/L2 periods | L1/L2 personal timelines and saved history | L1/L2 case comparison; deeper levels require separate admission |
| Hermetic decans | Source-reconstructed direct-import research catalog; closed product exclusion | Unavailable | Unavailable | No current product work; any future proposal is a new source-admission project |
| Persian/Medieval Firdaria | Complete, separately labelled | Not in Hellenistic page | Optional personal Traditional-timing lane | Full Traditional research lane; never called Hellenistic |
| Dorothean moment inspection | Complete | One user-supplied moment summary | Finite user-supplied candidate comparison | Bounded constraint scans and saved window sets |
| Primary directions | Complete mixed-lineage subsystem | No practitioner workbench | Current/next named Ptolemaic result only after scoped validation | Full existing workbench with every method's lineage shown |
| Multi-technique timeline | Caller composes | One current-period summary | Saved personal lanes; no merged verdict | Synchronized case lanes, annotations, and reproducible receipts |
| Persistence | Caller owns it | Current session plus existing Free chart allowance | Unlimited personal charts, dossiers, timelines, preferences | Client/case projects, reusable policies, research sessions |
| Export | Caller composes | Browser print and raw result receipt | Personal PDF/JSON/CSV/ICS | Batch/client packages and report templates |
| Alerts | Caller composes | None | User-authored personal transitions | Case alert queues and saved predicates |
| Hosted API | Self-hosted API is complete | Browser-only hosted use | Personal composition API only after abuse/security design | Workspace batch/case API |
| Collaboration | Caller owns it | No | No | One practitioner seat at launch; teams deferred |
| Hosted kernel | Caller-selected admitted resource | DE440 | DE440 | DE441 for extended research coverage |
Free must remain useful without an account. Existing Free chart-storage limits may remain, but the Hellenistic calculation itself should not acquire an artificial daily quota. Reuse the current public-compute guard.
Required kernel copy:
Free and Enhanced use JPL DE440. Urania Workspace uses JPL DE441 for extended research coverage. Technique definitions and doctrinal policies are identical. Every result identifies its kernel and coverage.
DE441 must not be marketed as secret doctrine or "more accurate astrology."
Product experience
Free: Hellenistic essentials
Create a public /hellenistic-astrology experience that answers four useful
questions in one coherent flow:
- Is this a day or night chart, and what follows directly from that sect basis?
- What are the visible condition components for the seven classical planets?
- Where are the four foundational lots, and how were they calculated?
- What annual profection and current ZR/Decennials periods are active now?
The page must show formulas, named policies, sources, and uncertainty/failure states. Locked cards may preview personal continuity and practitioner tools, but must not conceal the method used by visible results.
Enhanced: personal Traditional study
Enhanced adds continuity around one person's charts:
- Saved full condition dossiers and receptions.
- The existing ten curated lots and saved comparisons.
- Full profection schedules and arbitrary-date lookup.
- Full personal ZR timelines, Fortune/Spirit comparison, and transitions.
- Admitted Decennials L1/L2 timelines.
- An adjacent, correctly labelled Firdaria lane.
- Personal multi-lane timelines, exports, and user-authored reminders.
- Chart-aware explanations that cite the exact evidence they summarize.
Enhanced copy should say continuity and synthesis, not "advanced truth."
Workspace: Hellenistic and Traditional practice workbench
Workspace adds practitioner control and repeatability:
- Client/case organization and historical/BCE workflows.
- Full lot catalog, saved lot sets, networks, and cross-chart comparison.
- Dignity/bounds/face policy laboratory and side-by-side receipts.
- Multi-lot ZR comparison and synchronized profection/ZR/Decennials lanes.
- Full primary-directions instrument with source/lineage filtering.
- Finite Dorothean candidate comparison and bounded electional scans.
- Batch jobs, reusable policy profiles, annotations, imports, exports, report templates, and case-level audit history.
- Inspector-aware conversation and memory grounded only in serialized evidence.
Workspace should initially remain one named practitioner seat. Teams, white-labelling, unlimited automation, and public write API are later commercial decisions, not launch requirements for a $19 tier.
Transport and composition architecture
Do not add entitlements to moira or moira_server. Hosted commercial gates
belong in the website tRPC/gateway and Workspace proxy.
Package/REST closure — complete
The six-gate engine roadmap now owns this receipt. Whole-sign
direction/overcoming, the typed non-interpretive chart profile, exact atomic
receipts, serializers, REST models, and OpenAPI schemas are complete.
Decennials fails closed above L2; its deprecated request compatibility field
accepts only omission or null, exposes no named selector, and Valens
distribution interpretation remains outside every Hellenistic profile.
The aggregate response should not create new doctrine. It should compose exact atomic receipts and preserve at least:
method_id
lineage
source_refs
policy_and_selectors
input_time_and_location_semantics
calendar_and_timescale
kernel_id_and_coverage
engine_version
derivation_or_evidence
warnings
not_evaluable_reasons
Hosted website surface
Recommended composition procedures:
hellenistic.catalog- public lineage, methods, sources, admitted selectors, omissions, and capability status.hellenistic.essentials- public compute for the complete Free snapshot.hellenistic.currentPeriods- public compute; server freezes one current instant.hellenistic.dossier- Enhanced persisted condition dossier.hellenistic.timeline- Enhanced personal lanes and arbitrary date/range.hellenistic.export- Enhanced personal PDF/JSON/CSV/ICS.hellenistic.alerts- Enhanced user-authored transitions.hellenistic.caseTimeline- Workspace case composition.hellenistic.compareCandidates- Enhanced finite manual comparison; Workspace adds saved case sets.hellenistic.scanElection- Workspace-only bounded scan.hellenistic.batch- Workspace-only bounded batch operation.hellenistic.auditReceipt- Workspace persistent audit retrieval.
Use existing publicComputeProcedure, protectedEnhancedProcedure,
workspaceProcedure, centralized entitlement helpers, and LockedFeature only
as a UI affordance. Server rejection must occur before engine work.
Composition rules:
- A dossier groups evidence; it does not manufacture an overall score.
- A timeline uses separate labelled lanes; it does not output a fate forecast.
- Candidate comparison shows each named predicate as pass, fail, or
not_evaluable. - Scans require explicit start, end, timezone, step, named constraints, and hard duration/candidate/result ceilings.
- Every saved composition records the exact atomic results, policy, engine, kernel, and source identities used.
Implementation sequence
0. Correct the product record
- Correct Firdaria and other lineage mislabelling.
- Correct Enhanced DE441 copy to DE440, the ten-lot/"28-lot" drift, unverified "500+ lots" copy, stale Directions deferral copy, and chart-library persistence wording.
- Generate catalog counts from the live admitted catalog rather than marketing literals.
- Freeze the tier matrix and capability names in one shared product contract.
1. Close package and atomic REST gaps — complete
- Whole-sign aspect/overcoming and the typed Hellenistic profile are exposed.
- Decennials L1/L2 policy fails closed for unsupported deeper levels.
- Receipt metadata and OpenAPI contract assertions are present.
- Package, REST, standards, validation, release, and compatibility records are release-gated.
The Valens distribution interpretation layer is a separate admission project. It does not block Free/Enhanced launch if it remains absent from their schemas.
2. Ship Free Hellenistic essentials
- Add the public route, typed composition adapter, source/method drawer, frozen current-period snapshot, accessible presentation, and honest failure states.
- Do not advertise Enhanced timing until its server entitlement paths exist.
3. Ship Enhanced continuity
- Add persistent dossiers, full personal timelines, date comparison, exports, and reminders.
- Add storage migrations only when persistence begins and isolate them from concurrent unrelated website schema work.
4. Extend Urania Workspace
- Add the full Hellenistic/Traditional practice mode to existing inspectors, timelines, chart library, primary directions, imports, conversation, and research memory.
- Add case compositions, bounded electional scans, batches, reusable policies, and audit receipts incrementally behind server-enforced capabilities.
5. Observe and harden
- Observe reliability, response size, and use for at least 30 days.
- Tune batching, caching, limits, and presentation only. Engagement metrics do not authorize doctrine changes, hidden defaults, scoring, or stronger claims.
Verification gates
Package and self-hosted REST
- Every admitted engine computation in scope has a tested atomic REST path or an explicit documented deferral.
- Self-hosted REST starts and operates without any hosted entitlement service.
- OpenAPI accounts for every request selector, response receipt, failure type, and admitted route.
- Whole-sign aspect direction/overcoming match their engine truth exactly.
- Decennials levels and deep methods reject unsupported combinations explicitly; serializers preserve the chosen method.
- The dignity timelord-distribution option is either functional with supplied evidence or absent from the public contract.
- No Valens distribution field is exposed until its source, policy, semantics, tests, and transport all pass an admission review.
- Focused unit/server/public-surface tests run first, followed by the complete
deterministic non-network suite, documentation consistency, package build,
artifact inspection, and
twine check, all with the project.venv.
Hosted website
- Entitlement tests prove
Free < Enhanced < Workspaceand Workspace inheritance. - Unauthorized rejections occur before parsing, engine work, storage, or export.
- Given the same input, engine, kernel, and policy, all tiers return identical atomic truth.
- DE440/DE441 differences are isolated as kernel/resource differences and never alter a doctrine selector.
- Every composition equals its recorded atomic components.
- Schema/copy tests reject Firdaria, Sahl, Ramesey, or Lilly content labelled Hellenistic.
- Selectors for sect, bounds, face, triplicity, lot reversal, releasing lot, time policy, direction method/key, and direct/converse mode remain visible.
- DST, calendar, local-date profection boundaries, day/night boundaries, exact
ZR transitions, BCE/historical cases, and
not_evaluablebehavior are tested. - Schemas and copy reject
overall_score,luck_score,best_date, universalverdict, and unqualifiedfavorableclaims. - Electional scans without finite intervals, declared constraints, and hard ceilings fail.
- Saved charts, dossiers, cases, and exports enforce object ownership and tenant isolation.
- Focused tests, full website tests, type check, production build, strict prerender, anonymous/Enhanced/Workspace staging smokes, and exact-artifact promotion all pass before production.
Explicit non-products and deferrals
Do not offer:
- Universal dignity, condition, luck, fate, auspiciousness, or confidence scores.
- Tier-dependent formulas, doctrine, source visibility, or failure reasons.
- Prognostic certainty, life advice, promised outcomes, or medical/financial decision guidance.
- A universal best-election finder or unbounded electional search.
- Hidden selectors, silent fallback, or AI-invented doctrine.
- Firdaria marketed as Hellenistic, or Sahl/Lilly rules marketed as ancient.
- DE441 marketed as spiritually superior or secret premium accuracy.
- Longevity as life-expectancy or death prediction.
- Triacontaeteris without recovered and admitted first-principles doctrine.
- Hephaistio L4, which is not admitted.
- Triplicity doctrine comparison until more than the single admitted Dorothean doctrine exists.
- Teams, white-labelling, or unlimited automation as launch requirements.
Launch measures
Hard targets:
- Zero tier-dependent atomic computation differences under an identical frozen request and resource profile.
- Zero lineage, private-data, invented-score, or hidden-selector contract leaks.
- At least 99.5% successful Free essentials requests.
- Free essentials p95 below 3 seconds.
- Enhanced personal timeline p95 below 8 seconds; otherwise use an asynchronous job with a durable receipt.
- Workspace scans and batches always obey published hard ceilings and never run as unbounded synchronous work.
Privacy-safe product measures may include completed essentials snapshots, method/source drawer use, saved dossiers, timeline composition, policy switches, exports, alerts, candidate comparisons, Workspace case/batch use, and conversion between tiers. These measures may improve workflow and presentation only.