chore: retire Discussion Framework workflow and retain lessons
Test / Tests and coverage
Intrepid/Prometeu/Studio/pipeline/head This commit looks good

This commit is contained in:
2026-11-16 16:45:34 +00:00
parent cd001ce2d9
commit fa37d0d0c7
8 changed files with 18 additions and 17 deletions
-4
View File
@@ -25,9 +25,5 @@ build
.DS_Store
# Discussion workflow state is local; only consolidated lessons are versioned.
discussion/*
!discussion/lessons/
!discussion/lessons/**
temp/
temp/**
+5 -1
View File
@@ -16,9 +16,13 @@ The root project is a monorepo with these main areas:
- `prometeu-compiler`: compiler core, build pipeline, frontend APIs, and the PBS frontend.
- `prometeu-infra`: shared infrastructure used across modules.
- `docs/`: normative specifications and architectural references.
- `discussion/`: workflow artifacts for agendas, decisions, plans, and lessons.
- `discussion/lessons/`: published engineering lessons and supporting assets.
- `test-projects/`: sample workspaces used for local development and tests.
Engineering discussions, decisions, plans and execution evidence are maintained in
the enclosing [Prometeu Engineering workspace](../README.md) using
[AI Engineering](../.ai-engineering/README.md).
## Current Product Shape
The Studio shell currently organizes the product around four workspaces:
+4 -3
View File
@@ -22,9 +22,10 @@ The runtime repository owns PBX, ISA, admission and VM execution. Studio's
their separate provenance and synchronization policy. [Roadmaps](../roadmaps/)
describe cross-domain planning, not an alternative contract source.
The operational lifecycle is `agenda -> decision -> plan -> implement -> lesson`.
Keep its artifacts in `discussion/` and use the local `discussion` CLI for state
transitions, validation and housekeeping. See [repository instructions](../../AGENTS.md).
Engineering discussions, decisions, plans and execution evidence are maintained
in the enclosing workspace's [AI Engineering project](../../../.ai-engineering/README.md).
Published lessons and supporting assets remain in `discussion/lessons/`.
See [repository instructions](../../AGENTS.md).
## Navigation verification
+3 -2
View File
@@ -41,7 +41,8 @@ are stable and do not imply language-version numbers.
Write specs in English with title, status, scope, authority, normative rules,
non-goals and conformance/exit criteria. Keep one owner per detailed contract;
summaries link to it. Only settled decisions may change normative behavior.
Agendas, decisions and plans live in `discussion/`, and completed teaching
material lives in `discussion/lessons/`; they are not parallel spec sources.
Engineering discussions, decisions and plans live in the enclosing workspace's
AI Engineering project. Published teaching material remains in
`discussion/lessons/`; neither is a parallel spec source.
See the [specification guide](../README.md) for other domains.
@@ -411,7 +411,7 @@ mature gameplay library is not a prerequisite.
- Replacing compiler, Packer, LSP, VM or human Debug semantics; a new general-purpose Studio source editor.
- Remote MCP, accounts/OAuth and network runtime discovery. Studio-owned stdio and local Codex preparation are the explicit DEC-0061 additions.
- Additional language implementation, persistent operation recovery or automatic task resumption.
- Integrated discussion-framework agendas/decisions/plans in the product; those are future work, not this runtime/DEV/MCP contract.
- Product-integrated engineering workflow management is outside this runtime/DEV/MCP contract.
## Exit Criteria
-1
View File
@@ -48,7 +48,6 @@ def verify(root, runtime):
["git", "ls-files", "--cached", "--others", "--exclude-standard", "-z"],
cwd=root, text=True).split("\0")
files = {root / name for name in tracked if name.endswith(".md")}
files.update((root / "discussion/workflow").rglob("*.md"))
files.add(root / "AGENTS.md")
files = sorted(path for path in files if path.is_file())
mirror_names = {"docs/vm-arch/ARCHITECTURE.md", "docs/vm-arch/ISA_CORE.md"}
+2 -2
View File
@@ -16,11 +16,11 @@ Each case is compiled in a fresh JVM/project outside the checkout. Checkout mode
The required corpus produces 168 observations: 28 cases × checkout/installed × optimized production stages, investigation-only unoptimized stages, and the public optimized facade. Unoptimized means omitting OptimizeIRVMPipelineStage and emitting original IRVM; it is not a public compiler flag. The expected runtime matrix is 108 executions: 27 compiled cases × checkout/installed × two optimization configurations, with 104 normal three-frame successes and four deliberately faulting controls. The file-private case must remain a structured source rejection in all six compile configurations.
Use --select id1,id2 or --origins checkout/installed for focused investigation. Without those restrictions, exit zero requires the complete expected matrix and classifications. Output directories cannot be reused or target the original AGD-0113 baseline. Runtime processes are terminated and waited for on every path. Logs are local evidence, while summary.json and per-case JSON preserve structured results.
Use --select id1,id2 or --origins checkout/installed for focused investigation. Without those restrictions, exit zero requires the complete expected matrix and classifications. Output directories cannot be reused or target published lessons and their evidence. Runtime processes are terminated and waited for on every path. Logs are local evidence, while summary.json and per-case JSON preserve structured results.
The focused-cases.json resource is an additional matrix for contextual overloads, noncommutative receiver/argument order, original global storage, service singleton identity and privacy. It does not replace or alter the frozen corpus. Successful compiler proof does not imply qualification of an installed runtime distribution or a live Studio session. The Studio tests independently preserve MCP/LSP diagnostic contracts.
The completed DEC-0088/PLN-0166 result, original baseline and separate post-fix reports are consolidated in [LSN-0106](../../discussion/lessons/DSC-0111-pbs-production-reproductions-and-fixes/LSN-0106-pbs-production-binding-and-lowering-corrections.md).
The completed production corrections, original baseline and separate post-fix reports are consolidated in [LSN-0106](../../discussion/lessons/DSC-0111-pbs-production-reproductions-and-fixes/LSN-0106-pbs-production-binding-and-lowering-corrections.md).
## Installed authoring contracts
+3 -3
View File
@@ -133,9 +133,9 @@ def main():
corpus, distribution, binary, output = args.corpus.resolve(strict=True), args.distribution.resolve(strict=True), args.runtime_headless.resolve(strict=True), args.output.resolve()
if output.exists():
parser.error("Output must be a new directory; evidence is never overwritten")
baseline = ROOT / "discussion/workflow/agendas/AGD-0113-evidence"
if output == baseline or baseline in output.parents:
parser.error("The frozen baseline is read-only")
lessons = ROOT / "discussion/lessons"
if output == lessons or lessons in output.parents:
parser.error("Published lessons and their evidence are read-only")
output.mkdir(parents=True)
cases = json.loads(corpus.read_text())["cases"]
if args.select: