bill/whetstone_DSL
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sprint 3 plan and docs: adopt canonical annotation system from annotations/Memory strategy.md

Browse Source 
- Add Sprint 3 plan (37 steps, global 39-75) with canonical memory annotations,
  test quality requirements, global step numbering, and Sprint 2 overlap notes
- Refactor all docs to use canonical annotation families (@Deallocate, @Lifetime,
  @Reclaim, @Owner, @Allocate) replacing simplified @deref 4-strategy system
- Replace @perf with canonical @Hot/@Cold, @Inline, @Pure from annotations/6 optimization
- Replace @memory-footprint, @execution-mode, @deref-explicit with canonical equivalents
- Update REQUIREMENTS_OVERVIEW, SPRINT_1_REQUIREMENTS, SPRINT_2_PLAN, SPRINT_2_VISION,
  C++ Implementation Roadmap, example files, and progress report
- Remove duplicate bonus steps 41-42, consolidate Phase 3h from 7 to 4 steps

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Bill
2026-02-07 08:11:23 -07:00
parent ab05001068
commit 6643b7c2c7
11 changed files with 550 additions and 78 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/SPRINT_1_PROGRESS.md
View File

@@ -66,7 +66,7 @@ This generates correct Java: `SEnumOperations.isMember(SPropertyOperations.getEn
- All Literals: IntegerLiteral, FloatLiteral, StringLiteral, BooleanLiteral, NullLiteral, ListLiteral
- IndexAccess, MemberAccess
- Type nodes: ListType, SetType, MapType, TupleType, ArrayType, OptionalType, CustomType
- Annotations: DerefStrategy, OptimizationLock, LangSpecific
- Annotations: Memory strategy (initially `DerefStrategy`, canonical: `DeallocateAnnotation`/`LifetimeAnnotation`/`ReclaimAnnotation`/`OwnerAnnotation`/`AllocateAnnotation`), OptimizationLock, LangSpecific
- TargetLanguage enum (python, cpp, both)
**Status:** All TR-1 core AST nodes are defined. Annotation structures (TR-2, TR-3, TR-4) exist but may need property refinement.
@@ -101,7 +101,7 @@ This generates correct Java: `SEnumOperations.isMember(SPropertyOperations.getEn
- `IndexAccess_TextGen` — outputs `[target][[index]]`
- `MemberAccess_TextGen` — outputs `[target].[memberName]`
- All Type TextGens (List, Set, Map, Tuple, Array, Optional, Custom) — placeholders
- `DerefStrategy_TextGen` — outputs `@deref([strategy])`
- `DerefStrategy_TextGen` — outputs `@deref([strategy])` (to be updated to canonical annotation names like `@Reclaim(Tracing)`, `@Deallocate(Explicit)`, etc.)
- `OptimizationLock_TextGen` — outputs `@lock([lockedBy], [lockReason])`
- `LangSpecific_TextGen` — outputs `@lang([language]:[idiomType])`