From c39a436abc19f5ca1dd5f06b826e495281f62d56 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 20:07:57 +0100 Subject: [PATCH 1/8] docs(harness): plan managed Garnet persistence --- .../context-pack.md | 3 +++ .../drift.md | 3 +++ .../plan.md | 23 +++++++++++++++++++ .../research.md | 7 ++++++ .../supervisor.md | 3 +++ .../worklog.md | 7 ++++++ 6 files changed, 46 insertions(+) create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/context-pack.md create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/drift.md create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/plan.md create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/research.md create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/supervisor.md create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/worklog.md diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md new file mode 100644 index 0000000000..11dd2d5508 --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md @@ -0,0 +1,3 @@ +# Context pack + +Issue2636, branch fix/garnet-persistence from fresh origin/main b0eb07957. Bootstrap first, draft PR opens immediately. Add red tests before generator changes. DataPath enables AOF/recovery plus commit-freq0/commit-wait, log and checkpoints under bound /data or resolved executable path. No-path unchanged. Pinned2.2.1 lacks newer checkpoint-freq; use native on-demand checkpoint semantics. Runtime oracle must enqueue real jobs and prove checkpoint+AOF-tail recovery across container restart using emitted argv. Full scaffold.runtime required at end plus separate straightforward evaluator. No Streams, saga transports, dependencies/locks or unrelated lifecycle changes. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md new file mode 100644 index 0000000000..8b3e754026 --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md @@ -0,0 +1,3 @@ +# Drift + +rtk/rg absent; direct commands run as node. Pinned Deno2.9.7 via mise. Current maint:leak-check/maint:teardown and check:review-threads task names replace older agentic aliases. Public artifacts omit actual operator paths, hostnames/ports and session identities. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/plan.md b/.llm/runs/fix-garnet-persistence--issue-2636/plan.md new file mode 100644 index 0000000000..739cbbc23e --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/plan.md @@ -0,0 +1,23 @@ +# Plan + +## SKILL + +netscript-doctrine, netscript-harness, netscript-cli, netscript-pr, netscript-tools, netscript-deno-toolchain and jsr-audit. Aspire diagnostic skill applies to the required full runtime gate. + +## Locked contract + +Existing CacheEntry.DataPath is the opt-in persistence contract; no new settings. With it, every managed Garnet launch arm (Container, Executable and both Auto arms) enables AOF, recovery and immediate per-operation commits with acknowledgement waiting for flush. Docker logdir/checkpointdir both use /data, already bound from resolved DataPath. Executable uses the native resolveDataPath result for both directories. Preserve Lua flags and endpoint allocation. Without DataPath, argv and directory behavior remain unchanged. External/Local and Redis container behavior unchanged; the Docker-less Garnet fallback of Auto inherits persistence when its data path is configured. + +Durability favors acknowledged work over throughput; document flush latency and the underlying data directory requirement. Do not add unsupported checkpoint timers or unsafe AOF truncation. Checkpoints are native on-demand SAVE/BGSAVE; AOF recovers writes after the last checkpoint. + +## Slices + +S1 bootstrap plus failing static and real queue/container regressions, under12files. Runtime consumes emitted container argv, stores checkpointed and post-checkpoint jobs, restarts the owned Garnet container and observes delivery; no Redis Streams. Test resource bounds do not override persistence flags. Exact IDs plus unique ownership labels fence container/volume cleanup. +S2 minimal generator/helper import adjustments, green regressions, docs for durable vs ephemeral and commit tradeoff, under12files. +S3 canonical generated assets/prose/corpus/publish consumers, scoped CLI config check/lint/fmt/test, quality:gate, release:preflight, docs:accuracy, JSR/doc lint, one final full scaffold.runtime with cleanup, ownership audit and independent evaluation, under20files. + +Full runtime required because generated Aspire output changes. Local environment has remote Docker: do not weaken doctor or reproduce unrelated full-gate failures by changing product logic; supported-runner evidence must provide the complete verdict. No merge/auto-merge/ready-merge/rebase/force-push/publication. + +## Risks + +Unacknowledged async AOF tail loss -> explicit per-operation flush wait. Docker-less fallback silently ephemeral -> same policy on executable and both Auto arms. Latest documentation unsupported flags -> exact pinned help and real restart test. Unbounded log without checkpoints -> native on-demand checkpoint documented; no unsafe size cap. Wrong resource cleanup -> exact created identities, immutable unique label verification, keep foreign resources untouched. No new dependency or transport change. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/research.md b/.llm/runs/fix-garnet-persistence--issue-2636/research.md new file mode 100644 index 0000000000..5a124c3a56 --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/research.md @@ -0,0 +1,7 @@ +# Research + +Issue2636 read in full. Current generator passes only Lua/transaction flags to Garnet containers and dotnet executables. Container DataPath is bound at /data but no logging/recovery flags reference it; Executable ignores DataPath. Auto includes both native launch arms and can fall back from Redis/DenoKv to Garnet. usesResolvedDataPath currently excludes the Garnet Executable arm. + +Verified upstream primary configuration documentation: https://microsoft.github.io/garnet/docs/getting-started/configuration . Verified exact pinned ghcr.io/microsoft/garnet:2.2.1 --help in an owned auto-removed container: AOF/recover are disabled by default; logdir/checkpointdir accepted; aof-commit-freq0 commits per operation, aof-commit-wait delays acknowledgement until log flush. This pinned binary does not expose the newer checkpoint-freq option; do not add unsupported automatic-checkpoint scheduling. + +Queue RedisAdapter is a Redis-compatible list/lease implementation and supports Garnet without Streams. Runtime oracle will consume generated container argv and use the real queue adapter across an owned container restart. No queue source change needed. Read AGENTS, doctrine, harness and netscript-cli/tools/pr/deno-toolchain skills and existing generator/cache readiness/queue tests. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/supervisor.md b/.llm/runs/fix-garnet-persistence--issue-2636/supervisor.md new file mode 100644 index 0000000000..5a96c51a95 --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/supervisor.md @@ -0,0 +1,3 @@ +# Implementation lane + +Issue2636, milestone0.0.10. Branch fix/garnet-persistence from freshly fetched origin/main b0eb079575968e843b781579673c9fe2ae250e07. Existing owner-selected Codex gpt-6.1-sol/xhigh generator. Straightforward tier: native Garnet configuration forwarding, no new schema/lifecycle abstraction. PLAN-EVAL N/A: exact pinned-binary flags verified, durable/no-path policy locked. Mandatory independent IMPL-EVAL glm_5_3_flash/provider_default, fallback deepseek_v4_pro/provider_default, different session/vendor family. No implementation subagents. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md new file mode 100644 index 0000000000..ca1bb44f9c --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -0,0 +1,7 @@ +# Worklog + +## Design + +Public contract remains CacheEntry.DataPath. The existing generator composes upstream AOF/recovery/commit flags at each Garnet launch edge, with /data in containers and resolved host DataPath for executable. No new runtime abstraction. Durable writes wait for native AOF flush; ephemeral mode preserves existing argv. Tests use emitted configuration and real queue delivery after restart, including a checkpoint plus later AOF tail. Docs state modes and latency/retention behavior. PLAN-EVAL N/A for this locked native configuration passthrough; mandatory independent final evaluation. + +Fresh main b0eb07957 confirmed before branch creation. Pinned server help verified in an owned auto-removed container. Baseline static/runtime regressions next; no product implementation. From 70ab17fb9ad70e75929233137a46d8f5765e008e Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 20:20:43 +0100 Subject: [PATCH 2/8] test(aspire): reproduce lost Garnet queue data after restart --- .../context-pack.md | 2 + .../drift.md | 2 + .../plan.md | 4 +- .../research.md | 2 + .../worklog.md | 9 + .../helpers/tests/garnet-persistence_test.ts | 214 ++++++++++++++++++ 6 files changed, 231 insertions(+), 2 deletions(-) create mode 100644 packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md index 11dd2d5508..0b6113f2d2 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md @@ -1,3 +1,5 @@ # Context pack Issue2636, branch fix/garnet-persistence from fresh origin/main b0eb07957. Bootstrap first, draft PR opens immediately. Add red tests before generator changes. DataPath enables AOF/recovery plus commit-freq0/commit-wait, log and checkpoints under bound /data or resolved executable path. No-path unchanged. Pinned2.2.1 lacks newer checkpoint-freq; use native on-demand checkpoint semantics. Runtime oracle must enqueue real jobs and prove checkpoint+AOF-tail recovery across container restart using emitted argv. Full scaffold.runtime required at end plus separate straightforward evaluator. No Streams, saga transports, dependencies/locks or unrelated lifecycle changes. + +Red baseline proved before source modification: no-path3pass; DataPath3missing-AOF failures; real AOF-only restart loses both ready jobs after server readiness. Native checkpoint alignment failure is separate upstream/pinned behavior, addressed by native FileStream+storage-tier configuration in durable mode. Docker port rediscovery/native TCP fixture corrections are excluded from finding evidence. No test-owned containers/volumes remain. Next minimal generator implementation. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md index 8b3e754026..4c669e22fe 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md @@ -1,3 +1,5 @@ # Drift rtk/rg absent; direct commands run as node. Pinned Deno2.9.7 via mise. Current maint:leak-check/maint:teardown and check:review-threads task names replace older agentic aliases. Public artifacts omit actual operator paths, hostnames/ports and session identities. + +- Runtime research found a pinned native checkpoint alignment failure before any generator change. Original checkpoint probe failure is excluded as proof of the reported missing-AOF finding. Added an AOF-only restart oracle to isolate data loss. Durable launch policy now includes FileStream plus storage-tier, following the confirmed upstream configuration workaround for4K-sector storage, with both directories sharing the configured data path. This is native provider configuration within the existing contract; no version bump or unsupported scheduler. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/plan.md b/.llm/runs/fix-garnet-persistence--issue-2636/plan.md index 739cbbc23e..89467cb4d2 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/plan.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/plan.md @@ -6,13 +6,13 @@ netscript-doctrine, netscript-harness, netscript-cli, netscript-pr, netscript-to ## Locked contract -Existing CacheEntry.DataPath is the opt-in persistence contract; no new settings. With it, every managed Garnet launch arm (Container, Executable and both Auto arms) enables AOF, recovery and immediate per-operation commits with acknowledgement waiting for flush. Docker logdir/checkpointdir both use /data, already bound from resolved DataPath. Executable uses the native resolveDataPath result for both directories. Preserve Lua flags and endpoint allocation. Without DataPath, argv and directory behavior remain unchanged. External/Local and Redis container behavior unchanged; the Docker-less Garnet fallback of Auto inherits persistence when its data path is configured. +Existing CacheEntry.DataPath is the opt-in persistence contract; no new settings. With it, every managed Garnet launch arm (Container, Executable and both Auto arms) enables AOF, recovery and immediate per-operation commits with acknowledgement waiting for flush. Durable mode also selects the native FileStream device and storage tier so checkpoint/log buffers use the actual data-device alignment on4K-sector storage. Docker logdir/checkpointdir both use /data, already bound from resolved DataPath. Executable uses the native resolveDataPath result for both directories. Preserve Lua flags and endpoint allocation. Without DataPath, argv and directory behavior remain unchanged. External/Local and Redis container behavior unchanged; the Docker-less Garnet fallback of Auto inherits persistence when its data path is configured. Durability favors acknowledged work over throughput; document flush latency and the underlying data directory requirement. Do not add unsupported checkpoint timers or unsafe AOF truncation. Checkpoints are native on-demand SAVE/BGSAVE; AOF recovers writes after the last checkpoint. ## Slices -S1 bootstrap plus failing static and real queue/container regressions, under12files. Runtime consumes emitted container argv, stores checkpointed and post-checkpoint jobs, restarts the owned Garnet container and observes delivery; no Redis Streams. Test resource bounds do not override persistence flags. Exact IDs plus unique ownership labels fence container/volume cleanup. +S1 bootstrap plus failing static and real queue/container regressions, under12files. Runtime consumes emitted container argv, runs an AOF-only restart oracle plus checkpointed/post-checkpoint jobs, restarts the owned Garnet container and observes delivery; no Redis Streams. Test resource bounds do not override persistence flags. Exact IDs plus unique ownership labels fence container/volume cleanup. S2 minimal generator/helper import adjustments, green regressions, docs for durable vs ephemeral and commit tradeoff, under12files. S3 canonical generated assets/prose/corpus/publish consumers, scoped CLI config check/lint/fmt/test, quality:gate, release:preflight, docs:accuracy, JSR/doc lint, one final full scaffold.runtime with cleanup, ownership audit and independent evaluation, under20files. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/research.md b/.llm/runs/fix-garnet-persistence--issue-2636/research.md index 5a124c3a56..1c2f21fb10 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/research.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/research.md @@ -5,3 +5,5 @@ Issue2636 read in full. Current generator passes only Lua/transaction flags to G Verified upstream primary configuration documentation: https://microsoft.github.io/garnet/docs/getting-started/configuration . Verified exact pinned ghcr.io/microsoft/garnet:2.2.1 --help in an owned auto-removed container: AOF/recover are disabled by default; logdir/checkpointdir accepted; aof-commit-freq0 commits per operation, aof-commit-wait delays acknowledgement until log flush. This pinned binary does not expose the newer checkpoint-freq option; do not add unsupported automatic-checkpoint scheduling. Queue RedisAdapter is a Redis-compatible list/lease implementation and supports Garnet without Streams. Runtime oracle will consume generated container argv and use the real queue adapter across an owned container restart. No queue source change needed. Read AGENTS, doctrine, harness and netscript-cli/tools/pr/deno-toolchain skills and existing generator/cache readiness/queue tests. + +Pinned runtime probe independently hit native SAVE checkpoint alignment failure on4K-sector storage, matching https://github.com/microsoft/garnet/issues/2239 . Its confirmed follow-up requires FileStream plus storage-tier with logdir/checkpointdir on the same data directory. The native completion/sandbox issue is also described at https://github.com/microsoft/garnet/issues/2228 . Both compatibility flags exist in the exact pinned help. Durable policy includes these supported settings without a dependency bump or weakening persistence; no-path remains unchanged. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index ca1bb44f9c..eda6d8d87e 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -5,3 +5,12 @@ Public contract remains CacheEntry.DataPath. The existing generator composes upstream AOF/recovery/commit flags at each Garnet launch edge, with /data in containers and resolved host DataPath for executable. No new runtime abstraction. Durable writes wait for native AOF flush; ephemeral mode preserves existing argv. Tests use emitted configuration and real queue delivery after restart, including a checkpoint plus later AOF tail. Docs state modes and latency/retention behavior. PLAN-EVAL N/A for this locked native configuration passthrough; mandatory independent final evaluation. Fresh main b0eb07957 confirmed before branch creation. Pinned server help verified in an owned auto-removed container. Baseline static/runtime regressions next; no product implementation. + + +## Main baseline reproduction + +Static controls: all three no-DataPath cases pass; Container/Executable/Auto DataPath cases fail because generated argv lacks AOF/recovery. Real AOF-only queue regression on unchanged main source: both jobs are ready before an owned hard restart; the restarted server answers PING, then delivers zero jobs instead of two. This is a genuine data-loss failure after readiness, not a boot/network failure. + +Two fixture problems were corrected before counting runtime evidence: a direct ioredis import was not declared in CLI (replaced by native Deno TCP for PING/SAVE; queue uses its own existing dependency), and Docker reallocated the dynamic published port on restart (re-read after start). Those bootstrap failures are excluded. Checkpoint control independently exposed pinned native4K alignment failure matching upstream2239; it is also excluded from proof of the missing-AOF finding. Durable policy includes supported FileStream plus storage-tier per the confirmed upstream workaround, with common log/checkpoint directory. No version change. + +Each runtime test verifies immutable container/volume IDs and unique ownership labels before cleanup. Post-run Docker scans show no test-owned containers or volumes. All other resources are untouched. Raw server logs are not retained in public run evidence. diff --git a/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts b/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts new file mode 100644 index 0000000000..7a99f4caf5 --- /dev/null +++ b/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts @@ -0,0 +1,214 @@ +import { assert, assertEquals, assertStringIncludes } from '@std/assert'; +import { retry } from '@std/async'; +import { z } from 'zod'; +import { RedisAdapter } from '@netscript/queue/adapters/redis'; +import { DEFAULT_TEMPLATE_REGISTRY } from '../../../../application/registries/template-registry.ts'; +import { SCAFFOLD_CACHE_CONTAINER_IMAGES } from '../../../../constants/scaffold/scaffold-container-images.ts'; +import { generateRegisterInfrastructure } from '../register/generate-register-infrastructure.ts'; + +await DEFAULT_TEMPLATE_REGISTRY.hydrate(); + +function generate(mode: 'Container' | 'Executable' | 'Auto', dataPath?: string): string { + return generateRegisterInfrastructure({ + databases: {}, + caches: { garnet: { Enabled: true, Engine: 'Garnet', Mode: mode, DataPath: dataPath } }, + }); +} + +for (const mode of ['Container', 'Executable', 'Auto'] as const) { + Deno.test(`Garnet ${mode} with DataPath enables flushed AOF and recovery`, () => { + const source = generate(mode, '.data/garnet'); + for ( + const flag of [ + '--aof', + '--aof-commit-freq', + '--aof-commit-wait', + '--recover', + '--storage-tier', + '--device-type', + ] + ) { + assertStringIncludes(source, flag); + assertEquals(source.split(JSON.stringify(flag)).length - 1, mode === 'Auto' ? 2 : 1); + } + assertStringIncludes(source, 'FileStream'); + assertStringIncludes(source, '--logdir'); + assertStringIncludes(source, '--checkpointdir'); + assertStringIncludes(source, 'resolveDataPath(appHostDir, ".data/garnet", "garnet")'); + if (mode !== 'Executable') { + assertStringIncludes(source, "'/data'"); + const match = /\.withArgs\((\[[^\n]+\])\)/.exec(source); + assert(match); + const args = z.array(z.string()).parse(JSON.parse(match[1])); + for (const flag of ['--logdir', '--checkpointdir']) { + assertEquals(args[args.indexOf(flag) + 1], '/data'); + } + assertEquals(args[args.indexOf('--aof-commit-freq') + 1], '0'); + assertEquals(args[args.indexOf('--device-type') + 1], 'FileStream'); + } + if (mode !== 'Container') assert(/import\s*\{[^}]*\bresolveDataPath\b/.test(source)); + }); + + Deno.test(`Garnet ${mode} without DataPath preserves ephemeral arguments`, () => { + const source = generate(mode); + assertStringIncludes(source, '--lua'); + assertStringIncludes(source, '--lua-transaction-mode'); + for ( + const flag of [ + '--aof', + '--recover', + '--logdir', + '--checkpointdir', + '--storage-tier', + '--device-type', + ] + ) { + assertEquals(source.includes(flag), false); + } + if (mode !== 'Executable') { + assertStringIncludes(source, '.withArgs(["--lua","--lua-transaction-mode"])'); + } + }); +} + +async function docker(...args: string[]): Promise { + const result = await new Deno.Command('docker', { args, stdout: 'piped', stderr: 'piped' }) + .output(); + assertEquals(result.code, 0, new TextDecoder().decode(result.stderr)); + return new TextDecoder().decode(result.stdout).trim(); +} + +async function command(hostname: string, port: number, value: 'PING' | 'SAVE'): Promise { + const connection = await Deno.connect({ hostname, port }); + const timer = setTimeout(() => connection.close(), 5_000); + try { + const encoded = new TextEncoder().encode(`*1\r\n$${value.length}\r\n${value}\r\n`); + let written = 0; + while (written < encoded.length) written += await connection.write(encoded.subarray(written)); + const bytes = new Uint8Array(512); + let reply = ''; + while (!reply.includes('\r\n')) { + const length = await connection.read(bytes); + assert(length !== null, 'Garnet closed before its reply.'); + reply += new TextDecoder().decode(bytes.subarray(0, length)); + } + return reply.split('\r\n')[0]; + } finally { + clearTimeout(timer); + try { + connection.close(); + } catch { /* The owned timeout already closed this connection. */ } + } +} + +for (const checkpoint of [false, true]) { + Deno.test({ + name: `generated Garnet DataPath launch delivers ${ + checkpoint ? 'checkpoint and AOF-tail' : 'AOF-only' + } jobs after restart`, + ignore: Deno.env.get('NETSCRIPT_TEST_GARNET_DOCKER') !== '1', + async fn() { + const source = generate('Container', '.data/garnet'); + const match = /\.withArgs\((\[[^\n]+\])\)/.exec(source); + assert(match, 'The generated container must supply native argv.'); + const args = z.array(z.string()).parse(JSON.parse(match[1])); + const image = SCAFFOLD_CACHE_CONTAINER_IMAGES.Garnet; + const owner = crypto.randomUUID(); + const label = `netscript.test-owner=${owner}`; + let volume: string | undefined; + let container: string | undefined; + let producer: RedisAdapter<{ id: string }> | undefined; + let consumer: RedisAdapter<{ id: string }> | undefined; + try { + volume = await docker('volume', 'create', '--label', label); + // A uniquely owned volume supplies the same persistent /data boundary as + // DataPath's generated bind mount, including on remote Docker daemons. + container = await docker( + 'create', + '--label', + label, + '--mount', + `type=volume,source=${volume},target=/data`, + '--publish', + '0.0.0.0::6379', + `${image.image}:${image.tag}`, + ...args, + ); + await docker('start', container); + const binding = (await docker('port', container, '6379/tcp')).split('\n')[0]; + let port = Number(binding.slice(binding.lastIndexOf(':') + 1)); + const daemon = Deno.env.get('DOCKER_HOST'); + const hostname = daemon?.startsWith('tcp://') ? new URL(daemon).hostname : '127.0.0.1'; + let url = `redis://${hostname}:${port}`; + const ready = () => + retry(async () => { + assertEquals(await command(hostname, port, 'PING'), '+PONG'); + }, { maxAttempts: 200, minTimeout: 20, maxTimeout: 50 }); + await ready(); + const name = `persistence-${owner}`; + producer = new RedisAdapter(url, name); + await producer.enqueue({ id: 'checkpoint' }); + if (checkpoint) assertEquals(await command(hostname, port, 'SAVE'), '+OK'); + await producer.enqueue({ id: 'aof-tail' }); + assertEquals((await producer.getHealth()).ready, 2); + // The server cannot flush during graceful stop; acknowledged writes must + // already be recoverable. Restart with the exact emitted native argv. + await docker('kill', '--signal', 'KILL', container); + await producer.stop(); + await docker('start', container); + const restartedBinding = (await docker('port', container, '6379/tcp')).split('\n')[0]; + port = Number(restartedBinding.slice(restartedBinding.lastIndexOf(':') + 1)); + url = `redis://${hostname}:${port}`; + await ready(); + consumer = new RedisAdapter(url, name); + const delivered: string[] = []; + const controller = new AbortController(); + const timer = setTimeout(() => controller.abort(), 5_000); + try { + await consumer.listen(async (message, context) => { + await context.ack(); + delivered.push(message.id); + if (delivered.length === 2) controller.abort(); + }, { signal: controller.signal, concurrency: 1, visibilityTimeout: 1_000 }); + } finally { + clearTimeout(timer); + controller.abort(); + } + assertEquals(delivered, ['checkpoint', 'aof-tail']); + assertEquals((await consumer.getHealth()).ready, 0); + } catch (cause) { + const diagnostic = container ? await docker('logs', container) : 'container not created'; + throw new Error(`Garnet restart probe failed. Server output: ${diagnostic}`, { cause }); + } finally { + await consumer?.stop(); + await producer?.stop(); + // Immutable IDs and unique labels prove ownership before each mutation. + if (container) { + assertEquals( + await docker( + 'inspect', + '--format', + '{{index .Config.Labels "netscript.test-owner"}}', + container, + ), + owner, + ); + await docker('rm', '--force', container); + } + if (volume) { + assertEquals( + await docker( + 'volume', + 'inspect', + '--format', + '{{index .Labels "netscript.test-owner"}}', + volume, + ), + owner, + ); + await docker('volume', 'rm', volume); + } + } + }, + }); +} From 1d44cd2d26fd45ce377a64fef224761800147efc Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 20:32:21 +0100 Subject: [PATCH 3/8] fix(cli): persist managed Garnet data and recover queued jobs --- .../drift.md | 2 + .../worklog.md | 16 +++++++ docs/site/data-persistence/kv-queues-cron.md | 33 ++++++++++++++ packages/cli/README.md | 13 ++++++ .../generate-register-infrastructure.ts | 43 +++++++++++++++++-- 5 files changed, 103 insertions(+), 4 deletions(-) diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md index 4c669e22fe..b2a7d695a4 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md @@ -3,3 +3,5 @@ rtk/rg absent; direct commands run as node. Pinned Deno2.9.7 via mise. Current maint:leak-check/maint:teardown and check:review-threads task names replace older agentic aliases. Public artifacts omit actual operator paths, hostnames/ports and session identities. - Runtime research found a pinned native checkpoint alignment failure before any generator change. Original checkpoint probe failure is excluded as proof of the reported missing-AOF finding. Added an AOF-only restart oracle to isolate data loss. Durable launch policy now includes FileStream plus storage-tier, following the confirmed upstream configuration workaround for4K-sector storage, with both directories sharing the configured data path. This is native provider configuration within the existing contract; no version bump or unsupported scheduler. + +- Preserved the existing semicolon-free generator style rather than adding broad mechanical punctuation churn. Structured formatting uses CLI quality settings with the sole per-file temporary semicolon override, measured passing on base and head; the new test uses canonical CLI settings. No shared formatter changes. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index eda6d8d87e..fca0cf96f4 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -14,3 +14,19 @@ Static controls: all three no-DataPath cases pass; Container/Executable/Auto Dat Two fixture problems were corrected before counting runtime evidence: a direct ioredis import was not declared in CLI (replaced by native Deno TCP for PING/SAVE; queue uses its own existing dependency), and Docker reallocated the dynamic published port on restart (re-read after start). Those bootstrap failures are excluded. Checkpoint control independently exposed pinned native4K alignment failure matching upstream2239; it is also excluded from proof of the missing-AOF finding. Durable policy includes supported FileStream plus storage-tier per the confirmed upstream workaround, with common log/checkpoint directory. No version change. Each runtime test verifies immutable container/volume IDs and unique ownership labels before cleanup. Post-run Docker scans show no test-owned containers or volumes. All other resources are untouched. Raw server logs are not retained in public run evidence. + + +## Generator implementation and live recovery + +Added one native durable flag set shared by container and executable generation; DataPath selects AOF/recovery, immediate flush acknowledgement, FileStream and storage-tier. Both paths use one log/checkpoint directory. Executable now imports/uses the existing resolveDataPath helper; no-path output keeps existing Lua/endpoint behavior. + +Combined generator and persistence suite33/33 pass, including both real owned-container AOF-only and checkpoint-plus-AOF-tail restart/delivery cases. Both jobs are delivered and acknowledged after hard restart. This also verifies the pinned device configuration workaround. Structured changed-file check/lint pass. Public CLI/guide docs describe durable/ephemeral modes and latency, native checkpoints, retained directory and external-server ownership. No dependencies or lock changes. + +Formatting decision: the edited generator already uses semicolon-free style on main. Preserved that style through a temporary formatter config identical to CLI quality except fmt.semiColons:false; the structured formatter passes on both base and repaired generator. New test uses canonical CLI quality format and passes. This avoids a425-line unrelated formatting diff; the functional generator diff is43lines. No repository formatting policy changed. + + +## Package gates + +quality:gate, release:preflight and docs:accuracy pass. CLI JSR audit/dry-run passes with25 existing doctrine/slow-type warnings; CLI doc lint is zero on both baseline and head. Structured check/lint and both style-scoped format checks pass. No lock churn. An additional private whole-output comparison could not load the detached baseline import graph because its workspace alias was unavailable; excluded as a fixture failure, with no assertion about byte-identical output. The three no-path regressions and25 adjacent generator tests remain the unchanged-behavior evidence. + +Ownership teardown preview reports zero run-owned cleanup commands. Foreign/unknown resources are left untouched. diff --git a/docs/site/data-persistence/kv-queues-cron.md b/docs/site/data-persistence/kv-queues-cron.md index 21b9cac854..e6f7749866 100644 --- a/docs/site/data-persistence/kv-queues-cron.md +++ b/docs/site/data-persistence/kv-queues-cron.md @@ -73,6 +73,39 @@ not a code change. > back to local Deno KV and cron to the in-memory adapter; your code is identical either way. See > [Orchestration with Aspire](/explanation/aspire/). +## Managed Garnet durability + +`DataPath` selects persistence for a managed Garnet cache: + +```json +{ + "NetScript": { + "Cache": { + "garnet": { + "Enabled": true, + "Engine": "Garnet", + "Mode": "Auto", + "DataPath": ".data/garnet" + } + }, + "PrimaryCache": "garnet" + } +} +``` + +| Configuration | Durability | +| --- | --- | +| `DataPath` set | AOF and checkpoint files live in the configured directory; startup recovers saved data and replays the AOF. | +| `DataPath` omitted | In-memory, ephemeral cache; queued jobs, saga state and timers are lost when the server restarts. | + +This applies to Container, Executable and Auto launches, including a Docker-less Garnet fallback. +Containers mount the directory at `/data`; executables pass its resolved host path. Durable mode +uses FileStream storage tiering so logs and checkpoint buffers share the data device's alignment. +Each acknowledged write waits for an immediate AOF flush, trading latency for restart durability. +Native `SAVE`/`BGSAVE` creates checkpoints and compacts the AOF; take checkpoints periodically as +data grows. Retain the directory when replacing a container. An External cache's server owns its +persistence configuration. + ## KV `getKv(config?)` returns a `WatchableKv` bound to the auto-detected backend. Keys are typed tuples, diff --git a/packages/cli/README.md b/packages/cli/README.md index 249e695ee4..08a2c578a7 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -113,6 +113,19 @@ prerequisites for signed-in chat; CI uses a stub provider. Private chat currentl host for credential-file permissions. SQLite uses the local Garnet fallback when Docker is absent; PostgreSQL requires Docker. Deno 2.9.7 and the pinned Aspire/.NET toolchain are required. +## Managed Garnet durability + +Set a Garnet cache entry's `DataPath` to retain queued work across restarts. Generated Container, +Executable and Auto launches enable AOF recovery and wait for each write's log flush before +acknowledging it. This adds disk latency. Containers keep log and checkpoint files under the +mounted `/data`; executables use the resolved `DataPath` for both. + +Without `DataPath`, managed Garnet remains ephemeral and loses its contents on restart. Durable mode +uses the FileStream storage tier for portable checkpoint I/O. Native `SAVE`/`BGSAVE` checkpoints +compact retained AOF history; keep the data directory when replacing a container. See +[KV, queues & cron](https://rickylabs.github.io/netscript/data-persistence/kv-queues-cron/#managed-garnet-durability) +for configuration. + ## Command map | Group | What it owns | diff --git a/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts b/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts index 22af4a6c82..86146eb91d 100644 --- a/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts +++ b/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts @@ -33,6 +33,18 @@ const CACHE_DEFAULT_PORT = 6379 /** Queue receipts require atomic Lua in every managed Garnet launch mode. */ const GARNET_LEASE_ARGS = ['--lua', '--lua-transaction-mode'] as const +/** DataPath opts into recoverable writes and portable checkpoint/device alignment. */ +const GARNET_PERSISTENCE_ARGS = [ + '--aof', + '--recover', + '--aof-commit-freq', + '0', + '--aof-commit-wait', + '--storage-tier', + '--device-type', + 'FileStream', +] as const + /** Deno KV Connect container image (shared KV over HTTP). */ const DENOKV_CONTAINER = { image: 'ghcr.io/denoland/denokv', @@ -396,8 +408,7 @@ function usesResolvedDataPath( ((entry.Mode ?? 'Container') === 'Container' && entry.DataPath !== undefined) ) || cacheEntries.some(([, entry]) => entry.DataPath !== undefined && - !['External', 'Local'].includes(entry.Mode ?? 'Container') && - !(entry.Engine === 'Garnet' && entry.Mode === 'Executable') + !['External', 'Local'].includes(entry.Mode ?? 'Container') ) } @@ -474,6 +485,13 @@ function garnetExecutableSetup( lines.push( ` const ${id}_workdir = ensureGarnetToolManifest(appHostDir, ${JSON.stringify(version)});`, ) + if (entry.DataPath) { + lines.push( + ` const ${id}_dataPath = resolveDataPath(appHostDir, ${JSON.stringify(entry.DataPath)}, ${ + JSON.stringify(name) + });`, + ) + } lines.push( ` const ${id} = await builder.addExecutable(${ JSON.stringify(name) @@ -487,9 +505,16 @@ function garnetExecutableSetup( lines.push(` const args = await context.args();`) lines.push(` await args.add('--port');`) lines.push(` await args.add(${id}_tcpEndpoint.property(EndpointProperty.TargetPort));`) - for (const arg of GARNET_LEASE_ARGS) { + const args = [...GARNET_LEASE_ARGS, ...(entry.DataPath ? GARNET_PERSISTENCE_ARGS : [])] + for (const arg of args) { lines.push(` await args.add(${JSON.stringify(arg)});`) } + if (entry.DataPath) { + for (const flag of ['--logdir', '--checkpointdir']) { + lines.push(` await args.add(${JSON.stringify(flag)});`) + lines.push(` await args.add(${id}_dataPath);`) + } + } lines.push(` });`) lines.push( ` const ${id}_hostPort = ${id}_tcpEndpoint.property(EndpointProperty.HostAndPort);`, @@ -529,7 +554,17 @@ function redisGarnetContainerSetup( ) lines.push(` .withEndpoint(${cacheEndpointOptions(entry.Port)})`) if (entry.Engine === 'Garnet') { - lines.push(` .withArgs(${JSON.stringify(GARNET_LEASE_ARGS)})`) + const args = entry.DataPath + ? [ + ...GARNET_LEASE_ARGS, + ...GARNET_PERSISTENCE_ARGS, + '--logdir', + '/data', + '--checkpointdir', + '/data', + ] + : GARNET_LEASE_ARGS + lines.push(` .withArgs(${JSON.stringify(args)})`) } if (entry.DataPath) { lines.push( From 3ab21381d4b475e3dbd9377415b9ef51fb0586e8 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 20:33:59 +0100 Subject: [PATCH 4/8] chore(docs): refresh Garnet durability consumer assets --- .llm/runs/fix-garnet-persistence--issue-2636/worklog.md | 5 +++++ .../src/infrastructure/docs/agent-docs-prose.generated.ts | 2 +- packages/mcp/src/publish-assets.generated.ts | 4 ++-- 3 files changed, 8 insertions(+), 3 deletions(-) diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index fca0cf96f4..efd181aec5 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -30,3 +30,8 @@ Formatting decision: the edited generator already uses semicolon-free style on m quality:gate, release:preflight and docs:accuracy pass. CLI JSR audit/dry-run passes with25 existing doctrine/slow-type warnings; CLI doc lint is zero on both baseline and head. Structured check/lint and both style-scoped format checks pass. No lock churn. An additional private whole-output comparison could not load the detached baseline import graph because its workspace alias was unavailable; excluded as a fixture failure, with no assertion about byte-identical output. The three no-path regressions and25 adjacent generator tests remain the unchanged-behavior evidence. Ownership teardown preview reports zero run-owned cleanup commands. Foreign/unknown resources are left untouched. + + +## Generated consumers + +Canonical prose, MCP export corpus, CLI asset barrel and publish assets refreshed in dependency order. Only prose carrier was dirty when --allow-dirty was used for export generation; warning reviewed. Corpus and publish freshness pass. Only the prose and MCP publish carriers change; template/barrel and symbol corpus remain current. Next one final full runtime smoke with cleanup, then independent evaluation. diff --git a/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts b/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts index c1796f10d8..43f7735e33 100644 --- a/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts +++ b/packages/mcp/src/infrastructure/docs/agent-docs-prose.generated.ts @@ -67,7 +67,7 @@ export const EMBEDDED_AGENT_DOCS_PAGES: readonly AgentDocsPage[] = [ ["pages/data-persistence/index.md","H4sIAAAAAAAA/62VTW8bOQyG7/4VBBYIGsPjWaC3njZIC7TofmSbbi/BAqYlekYdWdKSHLvOr19IsidOuwsETW+2RqIeku9L/QSvUREuIBGLE6VgaDb72DsBIaMuBjBxRyyw74kJEH4nvTXskgKmBANREnAqIIpKgMFCH/eAIKanLYLpMXQE0rsky9lsPv9AJrKV+Rxe2JFx7WkBTB7zXegX8M9I7MjC3mkPCHpIZMF4R0EvwbsdgQugPcGdRcU1CoHHA/HfL3rVJK/alp0ZDh7Xsuyc9uN66WIbSKVQt/lUc5ZtewrTXi6OSdKO+ADJj53L6Qdltx6Vap7baMkLaCwQgluCHEHiyIaWMJ+/+UJmLJUrJcmJGjQ9yQKERFwMsoB95CGnOpZl05MdPVlQZwapaUrO8+79p1KRkQQuwHAM353msGtqoCaHyckmjjtniRvsQhR1BhKaATsS0B4VeAwQA9wTx8bEsHEd+GjQwxrNQMEKjEGdh7srSY7pqWT0JXkMpd8tlpPtZWUptSllTRztWOUXA8kS/ggEq2ViJ1tcAVmnRWoxL0+hwa6ho0CMSitgOv0uIc+FVM7mxS2q6V3o4D7ao2JlMX0tzX0UflUat/FxD4YJsyZKGNdxSWgBEgGrRk7Sd1IwzcF4AkbtiXN9s4iZCIQSFsgx2WNAzICAXSaNDFjMmZ2IAbZOso/urmMwlLTYt5jgAm5KdeC2Gg+7jqk7UmXIUzUsvKYQv66EZbcjBrSYlFiWP8BOZ5TfyBhuvhFfccu0LXOdfCF1GFTxbdD7LMBnIH5thdns7uOokR16uNXItOEY9FXxdfU/GhW4RtazvxkCEJjQl52lC8ept+G4zf3PtYSXEMOTYfUIIq1MJO3PLxuDrM10eWF+G/eNRvitiK+KfOJ4F5w69O6+juTt2Z7Ebot8OJ9a313JviBMPW8mI5wD/iX53RAyMdgHwitrCxpayyS54bFY4wGrVjEjZ9NJwh9AOgo12FSW5pFUz2Af1FpnQRHsm1CW6kIMMm7Lw4U1iz07rQdPogWEz3H9bOByaTPsHqR6BL3uYyyFrVinYQ5Xo8bGOinP9mEBedw643TaUb2Vy3oTRTum2z9/PY30Z+OaQtVgNVhzurOAf6ANcd4Mq18eR8pNWMHVzTvgac8m5jF5Junj4/RkxCnU45H03xTD7v/uf//pGTcPu/Zy9i8wubahZAkAAA==","6f8dc01e6e3064c9c02bb111ba9f74b31c361d58c70cd88e5c85e37327bd718e",2404], - ["pages/data-persistence/kv-queues-cron/index.md","H4sIAAAAAAAA/7V865Ict7Hm/36KtLXhvmx1NWVZ2vCMSHo8pKzxUJzRzJBcL48OC12F7oa7GigBqB42LxH7ax9gYyP2Uc7/s29ynmQjM4G69DQvlnzksDRdFyCRmcjLl4n6As6fJ/BzLWvp4HeQW6MHg5uVclCJpQT5uiqF0g6eSn+dW1X5oQO/slKC0l4urfDKaKhEvhZL6Y4g+5OW3tGTs/U2g4WxkIt8JUHoApx0Dp93XniZ9B4mEvj5hbJyKnQxXRi7lB5ujV3T693nkVJ+3KuNnBZWbaWGv5u5S+GxyFdIunHSgdES/K6SBeRGeytyD2YrLTi5lVaUMBf5WurC0QyTiai9mRbSy9y7yQT8SsJcOg9iK1Qp5qUEUYjKSwsLazZ0/8RVykqQequs0RupfQon8EZaM82NXqgllCYXJSxEWeJsUEqPXJTgxEZCbgoJttZgNAgoReVNRcQoDZU1RZ0jjxO4VX5lag9zK3S+UnqJL/xW4UjKhSmMDdQ8/G3ndZoiHQx+8/KEJAwuX8miLiWx2oEAr/I1+JXwIHVQBuK60d6AwHG2qpB2KpbaOK9y1phjYq6xsDFW0gvSQqmcl1paB4UVStM66WkiSFhRlrKE25VCVsL5c3Ae316ZsnCQ19YZ6xIoZFFXEtZy5xJiRm5q7XFUonItZUUjl8ZUoAq5qYxHxv80WnlfuaPZzKp8vSvF3KVL5Vf1PFVm1qqPcE56NyuUWFqxcax+U17CNLLHpm67HA8Gk5uVBG+VwSXgknHWI2Ylce4//tf/joyjv5tl8qWWJXiTlix8XDKugpf9kVWnk8Hgiy/gxUrlK6is2iivthK8gdrJwWAyuVT5GlUCR7NqufLtU5PJYPAOnqKq/fu/wc2ukvAOHklmBO7Gd4N3MJ1OIfx78A6yc7mbbkVZSyY129/W7+B6p/OVNdrUbrqQssTJrRTF7NYqH1474q3vkrjxXQKLUixd0iwsiSJP4ZmTcHPzhPa0rFZyg9tT+R0x4lZ4HIluWilyr7bK71Km9rsDBiM7YFxw2bmpq1KCK80tq3izja38ucadXgm/SuE7oQF3mzewqUuv8KXcaFdvpHXHuIXZNrD1gJXQRYljeKtw86yklaAF8v8Kr4kScKfaWqbwnaltY3aO4JHUhqzwlSyUS+Dkhx8vE7g0zi+tvP7xSVjkTcfM3VkgW8N3cFXrQIpFywei2eopXAplyYiACHrpDSxE96GC1RnXrXDnb4TetcrMxpWIuUbxLmo0OCgWz34gy4rako10YimQnherQC24SmgHzsvKMRG5sVaW7D9Y1TeV1I4uJA2JyoE2aJVMvVzBf/zP/wMbU8gSlAeBhqs7ISjtvBQF0jj4zlhQem5qXcD3NzeXwW6ofO3ALBZEVIK7BwS89FYtl9J+rvEIk5K5WJTm1s3CAG42RvFa2EjnxDLKK4HS6OXU1lqT2e7yjJkRHGIgp7uoX04Tvo0EkeW40BJOLs8SFmlUvsGAXGVw32RVDzpMpjE4zOD/HMzlSqGb8myropMAJ0tJPgusdKbc4raNm6znJNGsboS36jWZSAc4Q0NdwqZRVGKuSuVxWykPrq4qYz2765W5xWvKQb4yTup0MPhzXZY//IiXBG+oKQ1XNKZ4boXdMcWnssT5cOMHPzi3Bn2Yq/MV6teVmM+V/+FH9HE02DF6gLlB9RUYXJBSKb2wwnlb5762Eja18+TP53KBng1XsVDWedxAjX9NIcutFF7+iD9H4wx1ANdldPDlwS4w87Xx5PK9YT6jNeVFbMw23CAKidRINnJBd3kO+UropUxoUwkOPfhSil7kJIQ2/+//tnzf0a4LbJdFP15CAfiV3IGwMshdFr/E4YTFZtl6iy+xsP7938jHsuFeiLr0vagqxlNpE0WEMKjcHXfCjhoFxaa44SnfMZVLwJraIwMl7oSwb2G+C49oXIUz9N+gQyQi3CSF8GIunASNehu9Aw9k/EraoYsDOhhxEIByEmUJZoEUbnhj4GCVNbl07ghEQ8Qt6jRTsBJoB5tAAt+1ZBytnAaNKkDAQt5SOOxo72gopCimpfReWrzvYFhrXC9aiuH4OASDK4Gca+JRYuGUNbZaqdI4U612sFWC2JfiS6NxCk8NyNdeWi1KcNJuVc4+VFlJJvgdZBu5MXYXhRpleclLndJEKfxAD51vo/Khiz9/DiPaR3P2urS5ZEH5iMqVL3dj0j8kWukpz8PLieH5KNqjIxjy/eGYVBmDe7tRWlEgSxmEdN6xOTp/DkVQNbzDO7GQW1maijZQjMJ5synXqNQoBPmqlGPeX33iAl2BM/z6DP4irJa+p/aBRSHu72RPrJFh/6VwHbYbBhsaTk9Ov3/86vLq4vnZo8dX9y2O/y/vljR8AlePH51dv3p2dTb7y8nV08c3+GfSZgtRfu7VK3rx1avJrL3Eg7x6NaFdXlnpyHo3HMB1RqYxtWHUxlK547DQ+DhbZnT5witKqkrSJNqkqGnTKY3ExlsXwDRE5kX7NsJYaZxlbXwXPGew4yjClVqupn5lMYCoap9wODeNsVzY0ymckgcJlnq+g04iSG4amRzWZWVwQWCJks3PkYEpnG2CncRV7Iegs+g7Z2Lzc0XkFcrK3IPIcUuE9bWx34GlXf/4pO/SRt9dXMGzy0cnN4/h+vzsEp5cnJ4/fgTW3E7zUqhNAiiFYMzRPBhkg8jXMy3ydQKPnvw4TuHxf798cnZ6djONOgQXT5/8jY2/xHQi7iZyWJfhZxpodcfBCnbYhmbglEw1usXcaM28TKvwTvq2tmVC1gi9xfuw/PPn08qUmFF0ln++veRr0UwgYbVDs1Z7sxFekeFnOaGKxX2J4TyHA1ZujJcUDc7wX9cgdVEZpT2Mzp8jqUjgOOlF762rIO2vdQMEpHBTaxIJirqzvEJqc75N3+IizjDL2YoyaUVwEySwEa8pNZAuLrxjXrMsWsunTIatNYquCdUtJUwFairHEdfxxmhMTCBpUF4T3oyASGeWY/KhjmwKeqaDFot92a1ykgLrB/DyNy9Orp6ePf3LT4MHZDSJRUO3v2WMxWhQOZhMmh2LCTAbDvwryGgyOcYwjknmKML1EiCcJCpak3KRTGOo3Fj97PBuyNrtoPTyUzui4zc5sBgnMK897EzN4Z2pMOzj0Cz71NbI0NCSe/UWI41sGDfAMMMw8MDGqG2Z4QINBUwYdOvigKzYHk0bOyuLlk3Prs6OIWs2VxZNtMOXsxBjvOL9xcm38rx7WOMZo3ArU5cFlKiCAcyhIMFboR2m4URdEwkJhzyyUJgNYj94PWWVOfvh8uLq5uTpDSrNSV9R6mppRYExSAhiZ8Fb4KrbGFzT9kbcyFNkhNlFbXMM3K2EySTkV5NJghEbhdN7uRYbd5ZajgERmfPf/S7+Re9kKbwITp75m6AZidEGMwdF0UiiH65TLkvI0Af20zGziGJvdKCF1GS8QCrcaHArdujcJby8uJsoMkWfmxQSfIt2zOgZLzHmg+fPB4NsKf35dsTR9MNxhuhFbTVuq+wF4i2oO+fbDDiLDuvpGfg2GjmXO5YDp44eURaXAIFIfGNRo32m25y5ZOfba+kvSMVdKl8jfWc6g9FGlaVyMje6cGP0PkhSJe10LXcEERkdUsUmqLoUjui+xmC2ON+y38mQaER7rSrkoQS10YngfzEJ6g9BfoaemfIzzXgMRjEPx78k54n0ZNn5NhqNh2jyvzM2RyDAVTJXC5U3lLMljLHWEEUxRNSjIou5l1+zJq4MGf0DOHYjOiZG+FWWsYUiInr+01h4dhWRKAoRn9my9/jjEJkH694atf0XkUeuErnsvX5p5UK9ZoeObO2l7oiHhiHcWlXXHGs9Ui5HWeyybG5MKYWmka7XquqyYYqGqYNONGaHvNlk0lVCEnZUNAYy2QK7XyLfRqMzXW/mQbYE43kzjRa1q+ucteLclNltzBbDmwV6Ibxxq3RhbkGWonIYsX6P6CsmdvPd/nZ4h0WcYKo3hqB+UTrTxABZXhonUXGzBOXiWIszGDX50DgBNBBX4jbcQRJqXUhb7siLURyB5qEJuRoet2lRGOUEAdvGM/Ksyp1vz7TySpTqjSxwjmhkM+UaA4TX0WjAsha2SAeDLMu8G8xmgC4m9W6gKOSGt7wX4T0n1cMeZD08HgwokYT1Fu6DuBXKx717DLMZVIQM9rwPLbbxAbJ0ITeOaxsMeJj1NnXSj14OayetGyYwFKXK5fCnBN5S+n4EwxO6gmhDiT9FsVF6CO/HDVlSe7trKFtv06X038bXeaMch7dDGPH+wYEpx8c0nillWprliEZ9mJIVTnEsXuxviZzfDpCLlx27iuAhwRs9daJdwcqMRinU8FgvEbpYmdqm+7yIiD/S5s36lZjnzBCk+Kw4gmH95RDe45W4T47gq1ff3Lv36t69e8SZLMs60qYKwJQw6H+GzGnt195KsQmrZRwsSB1rXmiRElA6L+sCGa7lbRmj7WCUBrhdeOBRkOMWTa9ZICeIZLZso5dDJB25QWExxmzoTYwd/jQew9sBQFdu2X95SwOla7lL/26UHg1nw/F7mD6AeAf3xPss4QlZwuPjwfs9roU6yz+JZR9RVTZxqJKxtINrxbDUu0YtPcZs6Lo6LwtvNiofDQBevkWmHsHhIRLYSksq5cWmOmIqHqbdi/DwIei6LOH9TwmPh0w6gqGTfph8YnBk4BH0dgyOd28M/xW+pBGRA2oBo9/wIlKzZsHNZnCC0strawkiIsdRCl3IApzSOWPAWB2jrYRFoh2D27u8lOkdoa23KZrg1Lu7gFUSkUKGz0L1tEWxWjHv42qfI3Atb/ffQ8Hv7W2cCbm3ljtk3ZCYNQx76sJCpXQIA1q8jpJkSh/qOafkTOeIiw7KUHBApSez4JQTllZUKzfurIlG/cSSZjRSuzD6eR5X1x9h9BZqWx7BkB46ms2IqSvj/NE3X/23Pw4TMsAUriCMuBNVxVabORKGDmwhxAr5spACKwEFMkd5uXF9K/fNnon74gtOHN1g0K0JfHvzYISzJzEG2QvRf+AULj6bcVvDR0J0jAgWIveYizgvdg5cW8Tl2COUIPcANvLLbT7eVoBKIwooxRtV7tpQmopY2OzhxS7KkzKeEIiQVAFBiZJQ6jSgnTggYjiQBUR7FJLULgOStggbHmZMfBSqnv1nKctw3lQYRFA7ApctrCxlqN/0gCliUdbL4jOQut6wGnApp1+9pTDofIsBDTGP/gjs44Amwnkuo/SCRu/Fm9iLQOlVR/gwC78w1Cz6ly5DQZau/rrEo7dUDsQVFoQbnbnYKKqBs0qFiBtGH8dzxpi/+g+gIZSSEXwSEspoI6aU4DeP9fFynD8G/G28D/eppE75B0NxARHppkGR6h0qmjJW+d1Rq+EPAvkPIvFNruLt7sR7uam8ayJ4uA9f4Ww/iNdNrZ9aloTC6nlT7UG50nJEVZWhIUDvNQxQRSeAjDRbd+ZHshS77rRf3rt3j9OyUuxgLv2tlDq4EhHI3M8nWjL+genb7RDUI+CiyuigtSFhCy1BTZLavnjU3VNvGQ5NyFYmETBPItT1nqp3YQ7wNVXIMTlyIRK7A6zCqAeswl1kFVpodRxWhYjeEwL0rtFhZtmj/oVLYz2t67R2HmvV5HGxDiZUifA1+dmUGxrMRnlPKEY0hGjz/Eoq27ZKNXyJEGVI2yNByuFVRMJurMgJ7O6o9UKUTjbpbDTqBHMDPh9twq0VVYWgEdKF8CSGregGDNwSokVtF/MddYVQXpjt25XgZBBY3oies8HB0dX8D1OE22TQtqJUhfBcCI1tT3ijwA4a7HA58w6ydoagNxmIooAsvn6hH/O7GYwipIG7GVPG9plH8uAzbFmNfs4PKqMfW2tsBqNsiBte2GKY4brDWwlkw6L8eUhYbDbEetDtMBs3VfieTc3Ai3W3JBp4AlVZk+ttgr18l3GI3c1LA0umciNU2Yu8uwb+QOzCODqHUR2I1B3dccgHUtPguunvaMpiwI6EOLjfnf/bt+BNm1nOTbHrZpZDfoeCOo51+EIafTMGvjgAZaB/kq/FpiplmpvNEENvHm74Qpa5QbTYtA2k6TAZUN47mwVjFiApRuNHMl2mIODr6Ubp2qNt2ihc7ZgiyKAyETT8AG0foizSde1VScGHlQ9DElogKUfwNUzgm3swIXt7IAsN0cevkO0/RSSzGYUqIegBK3NJJhM1NrYP4A4REKLEU6O9fO0hxlRnBVY50M7a3SkqcFv+GO9xNQRYAoPF5n2Kw3DEMdx/QFkQv+OkLh7je/HB1JskkpTiksbHnDJdo2K0zST5esbOjF1SuYMRG5N+E939++zyx2mjRBfYwlD7wtzqJPScKj1dlNQF2fQOh5Cv5wQ7rqW/ZA4Z92UfG+HughAHbMin9ndogoC6wt3xBzibXUwZZ2+CiDal5PBaYDK5LNt+0ri/kZ5GlXpUfPuWq3AIuHQ0iSGIAEi8bSfKd0fwB0almB+00oMKsCf3RV0uVHmB4zaSDzMz5ORXEks2NQqn4WTSLF9gOxJW4hqxdoiCb+/Dl9huJlDH5WuRI0dKtZbd7cOdd6eXzwIfSfTBHb6Qc3hBzb0u3ZMqFSSm2nh01uRJ+rJ900jyjSmGx/tC78Tnn971TzuzYL12I+A+vEnN/O8y92xSCbB4k2LSMXrJWx5TSrdBFAVNK5qINykLc0RX2FB0r0UenmlypFCJHaZqjpqdyByLXo0z9mdT+yTma3OJqhIcqSyiovW41GhcJ5QY9p4YJgdWnJDW3PHcR0D+mWnf23fLKZuCD5jbpJ9pfHLntYksdpfe7VrgsJkrvC2AcXCzff4mG8AnWygSCP/MZhildPqXmnoxw4RNmI2jAsS78TcNUNuyV0CmMtY/WkBOw3iMkTTzzGaiqo6czK30f2oRk6//8NXv8Q5FAPhPU3ymFqxOwXnYLJWJbUI7CpQxHqUR3uNA74M6dwxS6+cbviO3X335+68YndnTH6V5hcjsf44OcYWOM0crl8IWJZUGF3CLHaH7vUNUQ8cKw4eVaBTx4bcf1BOernF7FrMldmixVjeDtnemPaeCEHVsfunkWrH5JdIUnvgAVQc1jxOyI6RZ+NURDGNZer1N+4FXN2U7gq/v3TuQt7XIWEfuJEpsIHh6cfP4J86/vCzlhoIFhBgp8S+SO/20nL20NXsu+3cE2gyTUcNAN5OJvZycPmGKJbCdvHvcpxBuNTfCFlhXxfLy1eUpvXt9/Zh8D4MgBxK9owBafCBHo9L/TbPE30Fplkull59b9DdzbEYL8XS7yFj5P6UjXtl+09BhjBEfbp7JuN2520/ba1lqUYb9liPs1sdoVH+8uyiLzU0jVST4suUiUhID3T0odImBiUVCsbOaNqxA2FEXKBZqwmgHQZMaVnRJBU+HqRsWDkKpvGlWJ/eYxWUXfzVzbNMJLf4jVYyz5twUzrsRusbWM+wbw+M5K1kioI1q6rw7hqzWnXUR4VjZpUb74xae9FLQ6aZOixdgTMthDUd+7ckk1EnHtdVO41dXdtTWS/WHZSm90TCiqfaepuYK5cdpL5/YEMREOKCVkP3VzL/nO1nkIgf/tSi790g9mlxE0IvhSUzM/27mZwXio81xE9z4eEHkOFTzi+EselIttSgzVF3MAJCqldgqPNvRSc+p+kGZD2uWLg7rZzSs2HzfQkQhg3cNoNdW3BWXpxu+IOJMtqJB3JA/DNLJArJ7adodN5azmzStRsl42BjnuxRghSnjxu1+h4dy1PAeKWsbkzJ04maxYDycOyxRg3k4irI3G1ko4SVGLoPJ5LS/3z8GQDcPwQxrf83PXwc188a7gzS3rS19qJmcJxrFaEuQ0o402dg03SwB+PhYyzUebYouqIusfnMvQKvYYErHWvGJO1jqvpLFZi7CV6lvhSjq9kDEvvPQaRIZud9sgkYkbAk6HvTLO06QUW+Mbltr4D4Mn92cDnF5ZydPTyA+wZWPPQuJ3hRreVTfFkssl/gECJAZnmykVbmYPZW3r/5m7HoY0epaX2hs4+h34eBBtK7qG6yCdnQS81k24NzdhnV2hAcVLS1Ep+3ZNe6nYU9/EP5/sZJUMsTXiJ98mCa8gs3q7CyCzQ5OGV0S9qpZjS4KT96IVl/iFsv+zH9cI6lyuaP1sQzpbABCWJUpVd6H5RUG5Av1GkMT9IMa2/wQr8ZjBUpLYVPGv9iI9PuANuI1Y2M5xjChP8FsqholQ1PGExatuemoNKnzVc+cBYsF91K4MX7PpjEJ0TL1DVNzlMMLbOfMsiuZG1t8yxqWQK3X2tzqB8SWEztXHg9YQXyegfOCo68oHSoP1naBODayXXkHXX+LTsTY9iBfQIZofZAhyosjGY3nA3DnhTIILTSuKy44szCFL7NxwsKg9IcOAAqcNQsmnustPUkdegImeC6FjoMqabE/4Pfjfx3RDLHeyLL9wMsWI4ko3CyJJoNOVCQsbG4VoC4JOglLsmf9SnuxROiXagIIMceshmOsyhrM1FxvtYzRGzqbwt2xAo+V3eVZOhg8UQtJ3QnhsAMaJq4Zi+USMx7Pbjce4aBgM5y8b0+T4klIio5A6a1hFADqiosHvQgrtbUmHDJjU4Gkyg2yMMI9ZLRCVYabXo4AQ4qrWmdB9HQVZ3M1tWrSXsNnQm2gdeysMPO6wOPC1KewErXDzWVswzNsMEeeov1Ar0zDDx31y2EhJ8YpMRZpqKNDaqyZe5zF84P4GJtBKhvWGEniUrEe118g9qM2WWwhVLmbsjQOZLGNl06gE+IeymPR6reQVBtRxsSvEyESctc5OnfY97aNFkTRfQhI4R5EuETIUnj5CBdyRc8ixvq+ye07x+6jjg+7qx72lpa+ePz4/NHJ365f/fHkhyRMzolqdHJHB9xWC47hqXFWNoMn5TaocuFQCZ5sRu3eSqsW1O14q9DapXcojVlBn9CmQaSzpIOQMrbOlbtpju6srj4m1l8nyS6oEKOShA57t0n5l6HggXR9T3RBoIt7QwLgj/vrTt2hE75Ewx9hhTBGqxb7hYNu31u4l1Kq0NQY4k5rL/QyiNSbs+uL64B+flKlAkGIqmKhh/43TCKdd0TE6bT8EOj/nyigFuphEg6YQIwfO7aVuwF5e8ZkwOQ5tme2nDCaUJ2rWg8TGNEwB2WB2VvTbUgCec+GVWJfG9YjgoeNz/TN4vsMJTE+vjszWeMPzy3x9sHZQ5fFZ0wd2yLDdRoykNOXbiw0T1FUPfEqRwg1WpzHHSSiEtbJ/sWPSR77BQ+ONBregz+S8n05/XrYaQHFD1BYdB33D82199rxnsz41Ycp2pVAa/EwLcTuYvFCynXbIPrFF/B9PLuNPtzgZ0Swi3Gzoe/5YFlAM9SDXVb0yR88mzyZ4MomEwrjbqlK3vvMRPiKTjzlPpkQiODxRHT85sJkQvcmk04rV+hp7B/C7hWKuJo5meBpsd4nYz7w/RR05OhtpiV+BuUzPx8DIrfGIRLA+UM6GJzjowwMNlUUtxFledQChkBFJqnzcLCeaow7jwn7CTGKJs2F5XgcrLilc8JIo9rQUW9qvG564uJU2D63tObWdcuW7aly4LWNIvxL8WM8cePhmz/AufrzmHlH58H5hEio9ngnywXtKfxkUrMWWlw4lbRQGE8wt5tFxe8+YCs4HcTgCbA4F/0En6xdSJQ7HXOnrjH80AYdDoqnxTH1+FxUMx5HnrpiPcP/B8gqfMmE2nIwE2dojYBt+rxMxGAIKIps3etzb04UMof4kxSMlnYOYmvjsUVzut8bxlF4p2uLmr52MJkgQZPJ3earUuBZg37v1elK5mvIDtS8s/ghCeFcjacX4/kxOp6EJ8g0yMVC5j4dTOnETqejXzk6vcvYd3vEag/cYLXlb8NoEHNnSqoTIiKFjdU4MNqhDsLQP0747OY0Y7wbi+ht0y8GUfPaKY0Ny2iUmlBBOhz0pLzFnCI7HC0F1vJN5ky8YdqiP+JxewX/TqtnW7RwQIdeWK5PsRmCvkYzGODZRy5PN99MIqbSCb0mb32Jj7UfSwvfZ7JGf/YXWoQX0wrb1bGcnsvZytxOvQmfnlpvyQXNxhhUqQrJnMLLUzq+1XwNJ8YIv3ZKPhU2FVxXbYpjs/FRv9FzRwkxn+tqwNNmS3UKqbFfdDAdDF6ut59LX2M3sW17jDjXS6LoH3//Zzpej0MMBi//Eam0QzD7BwNq8sVTBCeXZ61lR18w/c+pyxzRZ1Ta4lMbJ3JlCL93xTq4X3pKB/8fq1sJhcBPAAA=","9798976a410864b8c86da9ccfe377070bf29ece01cd22f32652229d7e5afe643",20416], + ["pages/data-persistence/kv-queues-cron/index.md","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","d751c3f107e9558014eb82f0a215db933f50f307ae0fa48abd552367a0f1bd64",21645], ["pages/design-system/components/alert-dialog/index.md","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","c58a0d74f3e8ec5354967b63d84a423426737e05940ecfd10d83993682f0c797",4181], diff --git a/packages/mcp/src/publish-assets.generated.ts b/packages/mcp/src/publish-assets.generated.ts index b9067f6d4a..a8443aeb9c 100644 --- a/packages/mcp/src/publish-assets.generated.ts +++ b/packages/mcp/src/publish-assets.generated.ts @@ -307,7 +307,7 @@ export const MCP_EMBEDDED_DOCS_PROVENANCE: 'pages/web-layer/vite/index.md', 'pages/why/index.md', ], - sourceBytes: 3255674, + sourceBytes: 3256903, documentCount: 286, - sha256: 'fac2e9ae8649238e745dba7653ae153741b6a78ccc5a8ac767e50ff3e8f40467', + sha256: '62082463dd78d23423ce6096995f39011de9770408a015fe6f441e7e86674bce', }; From 1e16cc31d6ca06335e8cd5636e5c10d5675e37de Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 20:55:43 +0100 Subject: [PATCH 5/8] docs(harness): record green Garnet scaffold runtime gates --- .../fix-garnet-persistence--issue-2636/context-pack.md | 2 ++ .../runs/fix-garnet-persistence--issue-2636/worklog.md | 10 ++++++++++ 2 files changed, 12 insertions(+) diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md index 0b6113f2d2..f281572fcd 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md @@ -3,3 +3,5 @@ Issue2636, branch fix/garnet-persistence from fresh origin/main b0eb07957. Bootstrap first, draft PR opens immediately. Add red tests before generator changes. DataPath enables AOF/recovery plus commit-freq0/commit-wait, log and checkpoints under bound /data or resolved executable path. No-path unchanged. Pinned2.2.1 lacks newer checkpoint-freq; use native on-demand checkpoint semantics. Runtime oracle must enqueue real jobs and prove checkpoint+AOF-tail recovery across container restart using emitted argv. Full scaffold.runtime required at end plus separate straightforward evaluator. No Streams, saga transports, dependencies/locks or unrelated lifecycle changes. Red baseline proved before source modification: no-path3pass; DataPath3missing-AOF failures; real AOF-only restart loses both ready jobs after server readiness. Native checkpoint alignment failure is separate upstream/pinned behavior, addressed by native FileStream+storage-tier configuration in durable mode. Docker port rediscovery/native TCP fixture corrections are excluded from finding evidence. No test-owned containers/volumes remain. Next minimal generator implementation. + +Implementation and generated consumers complete:33/33 generator/persistence tests pass, including actual hard-container-restart AOF-only and checkpoint+AOF-tail job delivery. Scoped static/quality/preflight/accuracy/JSR/doc-lint/freshness gates pass (CLI doc lint zero base/head,25 existing JSR warnings). Supported final source-head full workflow43940698080 succeeds for Postgres, SQLite, static and native. Local one-pass partial due unavailable local Docker/Postgres, cleanup passes, ownership preview zero owned commands. Source head3ab21381d unchanged by evidence-only followup. Four issue boxes checked with linked IMPL proof; closing keyword/evidence block in body. Final independent straightforward IMPL-EVAL is required; retain draft until PASS and current required checks green/policy-skipped. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index efd181aec5..57a2eb26be 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -35,3 +35,13 @@ Ownership teardown preview reports zero run-owned cleanup commands. Foreign/unkn ## Generated consumers Canonical prose, MCP export corpus, CLI asset barrel and publish assets refreshed in dependency order. Only prose carrier was dirty when --allow-dirty was used for export generation; warning reviewed. Corpus and publish freshness pass. Only the prose and MCP publish carriers change; template/barrel and symbol corpus remain current. Next one final full runtime smoke with cleanup, then independent evaluation. + + +## Final full runtime attempt + +Final full scaffold.runtime one-pass local command exits1: documented-scaffold Postgres never becomes healthy within300seconds. Cleanup gate passes. This shell had no local Docker socket; the known remote daemon is reachable, but this host does not satisfy the generated AppHost's local-Docker contract. No guard or product behavior changed; no full local pass claimed. Follow-up read-only leak/teardown reports zero run-owned cleanup commands, foreign resources untouched. Final supported-runner workflow [43940698080](https://github.com/rickylabs/netscript/actions/runs/43940698080) at3ab21381d is still running; desktop/static lanes already pass. Independent final evaluation awaits the complete runtime verdict. + + +## Supported final runtime verdict + +[Workflow43940698080](https://github.com/rickylabs/netscript/actions/runs/43940698080) completes SUCCESS at source head3ab21381d. [Postgres full runtime](https://github.com/rickylabs/netscript/actions/runs/43940698080/job/133557631938) and [SQLite full runtime](https://github.com/rickylabs/netscript/actions/runs/43940698080/job/133557632129) both succeed, alongside scaffold-static and desktop-native packaging. No guard bypass or substituted gate. Local partial evidence remains recorded honestly. All four issue acceptance boxes have linked red/green runtime/generator/docs evidence in the IMPL comment. Follow-up commit records evidence only; no product/test/doc change after this green source head. Independent final IMPL-EVAL next, then ready transition and current required head checks/review-thread gate. From cf901366b2e08def827b682fedebeadebb0a8c9a Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 21:07:23 +0100 Subject: [PATCH 6/8] docs(harness): retain independent Garnet implementation approval --- .../context-pack.md | 2 + .../evaluate.md | 126 ++++++++++++++++++ .../worklog.md | 5 + 3 files changed, 133 insertions(+) create mode 100644 .llm/runs/fix-garnet-persistence--issue-2636/evaluate.md diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md index f281572fcd..e11919afae 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md @@ -5,3 +5,5 @@ Issue2636, branch fix/garnet-persistence from fresh origin/main b0eb07957. Boots Red baseline proved before source modification: no-path3pass; DataPath3missing-AOF failures; real AOF-only restart loses both ready jobs after server readiness. Native checkpoint alignment failure is separate upstream/pinned behavior, addressed by native FileStream+storage-tier configuration in durable mode. Docker port rediscovery/native TCP fixture corrections are excluded from finding evidence. No test-owned containers/volumes remain. Next minimal generator implementation. Implementation and generated consumers complete:33/33 generator/persistence tests pass, including actual hard-container-restart AOF-only and checkpoint+AOF-tail job delivery. Scoped static/quality/preflight/accuracy/JSR/doc-lint/freshness gates pass (CLI doc lint zero base/head,25 existing JSR warnings). Supported final source-head full workflow43940698080 succeeds for Postgres, SQLite, static and native. Local one-pass partial due unavailable local Docker/Postgres, cleanup passes, ownership preview zero owned commands. Source head3ab21381d unchanged by evidence-only followup. Four issue boxes checked with linked IMPL proof; closing keyword/evidence block in body. Final independent straightforward IMPL-EVAL is required; retain draft until PASS and current required checks green/policy-skipped. + +Independent IMPL-EVAL PASS at1e16cc31d, comment6927774411; no blocking findings. evaluate.md retained. Ready transition and final required-head check/thread verification next. No product source changes since supported green source head3ab21381d. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md b/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md new file mode 100644 index 0000000000..59bb0ff943 --- /dev/null +++ b/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md @@ -0,0 +1,126 @@ +# Evaluation: fix/garnet-persistence — issue #2636, PR #2643 + +Allowed result values: `PASS`, `FAIL`, `N/A`, `PENDING_SCRIPT`, `DEBT_ACCEPTED`, `NOT_RUN`. +Anti-pattern status values: `CLEAR`, `VIOLATION`, `DEBT_ACCEPTED`, `N/A`. + +## Metadata + +| Field | Value | +| -------------- | ------------------------------------------------------------------------- | +| Run ID | `fix-garnet-persistence--issue-2636` | +| Target | PR #2643 / issue #2636 — managed Garnet persistence from `DataPath` | +| Archetype | 6 — CLI/Tooling (CLI scaffold generator + generated Aspire runtime) | +| Scope overlays | docs (CLI README + data-persistence guide) | +| Evaluator | Independent IMPL-EVAL session; route `glm_5_3_flash/provider_default` (primary row of the straightforward implementation-evaluation matrix; no fallback needed); generator `Codex gpt-6.1-sol/xhigh` (OpenAI family) — separate session, different vendor family | +| Evaluated head | `1e16cc31d6ca06335e8cd5636e5c10d5675e37de` (branch `fix/garnet-persistence`, base `origin/main` `b0eb079575968e843b781579673c9fe2ae250e07`) | + +## Route / Identity Record + +- Live matrix row (straightforward, implementation-evaluation): primary `glm_5_3_flash/provider_default`, fallback `deepseek_v4_pro/provider_default`; policy maxRounds 5, notify after 3. +- Requested and observed identity: `glm_5_3_flash/provider_default` via OpenCode Go provider default options. No substitution, no fallback used, no paid-route expense. +- Generator vendor family (OpenAI/Codex) ≠ evaluator vendor family (GLM); separate sessions. + +## Process Verification + +| Check | Result | Evidence | +| -------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- | +| Plan-Gate passed before implementation | PASS | `PLAN-EVAL: N/A` justified and recorded in `supervisor.md`/`worklog.md` before commit `c39a436ab`: exact pinned-binary flags verified, locked durable/no-path policy, bounded native configuration passthrough per run-loop §4 skip criteria | +| Design section exists in worklog | PASS | `## Design` in `worklog.md` (public contract stays `CacheEntry.DataPath`, per-arm flag composition, docs modes) | +| Commit slices match design plan | PASS | 5 commits: `c39a436ab` plan → `70ab17fb9` red test → `1d44cd2d2` fix+docs → `3ab21381d` generated consumers → `1e16cc31d` evidence-only; every commit touches the run dir | +| Each slice has a passing gate | PASS | Red→green static oracle (below), combined suite, quality/JSR/doc gates, supported-runner full smoke | +| No speculative seams (unused files) | PASS | Diff adds one test file; generator change edits existing launch edges only; no new product files | +| Constants used for finite vocabularies | PASS | `GARNET_PERSISTENCE_ARGS` const array composes flags; test loops finite mode/flag lists | + +## Static Gates + +| Gate | Command or check | Result | Evidence | +| ---------------- | ----------------------------------------------------------------------------- | ------ | -------- | +| Slice typecheck | `.llm/tools/run-deno-check.ts --root packages/cli/src/kernel/templates/aspire/helpers --ext ts` | PASS | exit 0, 47 files, 0 failures | +| Lint | Repo lint policy excludes `packages/cli/` (pre-existing `deno.json` lint exclude); evaluator's direct wrapper invocation on this root correctly refused all-excluded — not a PR finding; root policy unchanged by this run | N/A (policy-excluded) | `deno.json` lint exclude list | +| Format (test) | `.llm/tools/run-deno-fmt.ts` on the new test under canonical CLI quality config (`lineWidth:100, indentWidth:2, semiColons:true, singleQuote:true`) | PASS | exit 0, 1 file, 0 findings | +| Format (generator) | Temporary per-file config identical to CLI quality except `semiColons:false`, per `drift.md`: PR-touched `generate-register-infrastructure.ts` has no findings; 9 findings in the register root are all in sibling files untouched by this PR (pre-existing style drift, excluded) | PASS (changed files) | evaluator-replicated run | +| Doc lint | `deno task doc:lint --root packages/cli --pretty` | PASS | exit 0, entrypoints `mod.ts`/`scaffolding.ts`/`testing.ts` all 0 | +| Publish dry-run | `deno publish --dry-run --allow-dirty` in `packages/cli` | PASS | exit 0, `Success Dry run complete` | +| JSR audit | `.llm/tools/fitness/audit-jsr-package.ts --root packages/cli --text` | PASS | exit 0, exactly 25 pre-existing WARN entries, none in changed files | +| Quality gate | `deno task quality:gate` (quality:scan + arch:check) | PASS | exit 0; listed warnings are pre-existing and in files untouched by this diff | +| Release preflight| `deno task release:preflight` | PASS | exit 0, four PASS lines | +| Docs accuracy | `deno task docs:accuracy` | PASS | exit 0, `docs accuracy: PASS` (216 published source pages, 111/111 public commands) | +| Link/path check | Docs diff reviewed: relative guide section, absolute docs-site URL only in README | PASS | `packages/cli/README.md`, `docs/site/data-persistence/kv-queues-cron.md` | + +## Pinned-Binary Flag Verification (independent) + +`ghcr.io/microsoft/garnet:2.2.1 --help` executed in an evaluator-owned auto-removed container confirms +every emitted flag exists in the pinned binary: `--aof`, `--recover` (`-r`), `--aof-commit-freq` +(default 0), `--aof-commit-wait`, `--storage-tier`, `--device-type`, `--logdir` (`-l`), +`--checkpointdir` (`-c`). No checkpoint-frequency scheduling option exists in the pinned help — +consistent with the no-unsupported-timer decision and upstream #2239 alignment workaround +(FileStream + storage-tier + shared log/checkpoint directory). + +## Runtime Gates + +| Gate | Validation | Result | Evidence | +| ---- | ---------- | ------ | -------- | +| Combined generator + persistence suite | Evaluator's own run of the exact test command with `NETSCRIPT_TEST_GARNET_DOCKER=1` and the remote Docker daemon: `deno run --allow-read --allow-write --allow-run .llm/tools/run-deno-test.ts -- --allow-all --unstable-kv packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts packages/cli/src/kernel/templates/aspire/helpers/tests/generate-register-infrastructure_test.ts` | PASS | exit 0, `passed:33 failed:0 ignored:0` — both real hard-restart oracles executed (AOF-only and checkpoint+AOF-tail: two ready jobs delivered and acked after `KILL`/start of an owned container fed the exact emitted argv) | +| Full scaffold runtime (supported runner) | Workflow 43940698080 at source head `3ab21381d4b475e3dbd9377415b9ef51fb0586e8` | PASS | run SUCCESS; scaffold-runtime (postgres) job success, scaffold-runtime-sqlite (sqlite+garnet) job success, scaffold-static success, desktop-native-linux job succeeded (one non-blocking step error annotation; job conclusion `succeeded`) | +| Local one-pass smoke | Generator-run local attempt stopped at Postgres health timeout (no local Docker); cleanup gate passed | PARTIAL (honestly recorded) | `worklog.md`; not claimed as a pass anywhere | +| Test resource hygiene | Post-run scan: zero containers/volumes bearing the test ownership label | PASS | evaluator's own post-run Docker scan | + +## Consumer Gates + +| Consumer | Validation | Result | Evidence | +| -------- | ---------- | ------ | -------- | +| Generated prose / MCP corpus / publish assets | Refreshed in `3ab21381d`; only prose and MCP publish carriers changed | PASS | `docs/agent-docs-prose.generated.ts`, `packages/mcp/src/publish-assets.generated.ts`; `docs:accuracy` PASS (independently re-run) | +| Source-head invariance | `git diff --exit-code` between `3ab21381d…` (evidence-green source head) and evaluated head `1e16cc31d…` | PASS | delta is only two `.llm/runs/…` run-artifact files | + +## Anti-Pattern Check + +| AP | Status | Evidence | Notes | +| -- | ------ | -------- | ----- | +| `any` / manual casting / blanket lint-ignores | CLEAR | Product diff scanned; zero hits; `quality:scan` inside `quality:gate` exit 0 | New test uses zod parse, typed adapters | +| New folder / template-shaped files | CLEAR | No new product folders or files | One test file under the existing tests folder | +| Public-surface change without contract | CLEAR | No public API change; `CacheEntry.DataPath` contract reused | `deno publish --dry-run` success | +| Unsupported upstream options invented | CLEAR | All emitted flags verified against the pinned binary help | No checkpoint timer added | +| Lock/dependency churn | CLEAR | `deno.lock` unchanged; no dependency additions | 12-file diff reviewed | +| Forbidden transport coupling | CLEAR | `packages/plugin-sagas-core/src/transports` diff is empty; queue path uses the existing public Redis-compatible adapter, no Streams | Requirement honored | + +## Arch-Debt Delta + +| Metric | Count | Evidence | +| --------------------- | ----- | -------- | +| New entries | 0 | No `arch-debt.md` change in the diff; no doctrine violation introduced | +| Resolved entries | 0 | n/a | +| Deepened violations | 0 | `quality:gate` exit 0 with pre-existing warnings only | +| Unrecorded violations | 0 | None found | + +## Findings + +| Severity | Finding | Evidence | Required action | +| -------- | ------- | -------- | --------------- | +| low (informational) | Supported-runner desktop-native job carries one non-blocking step error annotation while the job conclusion is `succeeded` | workflow 43940698080 job page | none; job-level verdict stands, recorded here for honesty | +| low (informational) | The described temporary generator formatter config passes on the PR-touched generator file, but nine untouched sibling files in the same register folder do not conform to it | evaluator-replicated fmt run | none for this PR; optional future hygiene slice if the folder is ever normalized | +| none blocking | — | — | — | + +## Close-Gate Posture (pre-transition) + +- PR body carries `Closes #2636` in `## Scope` and exactly one fenced `acceptance-evidence` block + mapping issue #2636 box-index 1–4 to the linked IMPL evidence comment. Issue acceptance boxes are + all checked with that linked evidence. +- PR `## Definition of Done` final box (independent evaluation, required checks, review threads) + correctly remains unchecked pending this verdict and the generator's post-PASS transition. + Readiness/label transition, current required checks, and the review-thread gate are the + generator's post-PASS responsibilities per the run contract — not evaluation blockers. +- No `status:ready-merge`, no merge, no publish authorized or performed by this evaluation. + +## Lessons for Promotion + +| Lesson | Pattern | Applies to | Confidence | +| ------ | ------- | ---------- | ---------- | +| Emitted-argv restart oracle beats flag-assertion-only tests for persistence work | Generate → parse argv → run the real binary → hard-restart → observe delivery | Archetype 6 runtime gates for cache/DB wiring | high | +| Pinned-binary `--help` verification before composing native flags | Exact-version container probe prevents inventing unsupported options | Any upstream-flag passthrough | high | + +## Verdict + +| Field | Value | +| --------- | ----- | +| Verdict | PASS | +| Rationale | Approved scope fully delivered: DataPath now selects native AOF/recovery, immediate flush acknowledgement, FileStream + storage-tier device configuration, and a shared log/checkpoint directory on every managed Garnet launch arm (Container, Executable, both Auto branches), while no-path launches are byte-identical to the prior Lua/endpoint argv (three no-path controls). Independently verified: 33/33 combined suite including both hard-restart delivery oracles, scoped typecheck, quality:gate, doc lint, JSR dry-run + audit (25 pre-existing warnings), release preflight, docs accuracy, formatter style preservation on changed files, pinned-binary flag existence, zero test-owned Docker residue, no transport/dependency/lock changes, and the supported-runner full smoke SUCCESS at the identical source head. No unrecorded doctrine violations; debt delta zero. Docs accurately describe both durability modes, latency tradeoff, native on-demand checkpoints, and directory retention. | diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index 57a2eb26be..bdb94478b6 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -45,3 +45,8 @@ Final full scaffold.runtime one-pass local command exits1: documented-scaffold P ## Supported final runtime verdict [Workflow43940698080](https://github.com/rickylabs/netscript/actions/runs/43940698080) completes SUCCESS at source head3ab21381d. [Postgres full runtime](https://github.com/rickylabs/netscript/actions/runs/43940698080/job/133557631938) and [SQLite full runtime](https://github.com/rickylabs/netscript/actions/runs/43940698080/job/133557632129) both succeed, alongside scaffold-static and desktop-native packaging. No guard bypass or substituted gate. Local partial evidence remains recorded honestly. All four issue acceptance boxes have linked red/green runtime/generator/docs evidence in the IMPL comment. Follow-up commit records evidence only; no product/test/doc change after this green source head. Independent final IMPL-EVAL next, then ready transition and current required head checks/review-thread gate. + + +## Independent implementation verdict + +[Separate-session IMPL-EVAL PASS](https://github.com/rickylabs/netscript/pull/2643#issuecomment-6927774411) at1e16cc31d. GLM5.3Flash/provider-default matches pinned primary and is independent from OpenAI generator. Evaluator independently executes33/33 live generator/persistence tests, verifies pinned flags, scoped typecheck47files, quality, preflight, docs accuracy, doc lint zero, JSR audit/dry-run and supported full smoke source invariance. No blocking findings; only existing sibling format drift and non-blocking CI annotation. Owned resource scan empty. Final evidence-only verdict commit precedes ready-for-review transition; verify current required checks and review threads after transition. From 7cbcfbd3a17e1ddd715c464d589705084ccdf3f6 Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 21:22:13 +0100 Subject: [PATCH 7/8] style(cli): satisfy required canonical generator formatting --- .../context-pack.md | 2 + .../drift.md | 5 + .../worklog.md | 5 + .../generate-register-infrastructure.ts | 396 +++++++++--------- .../helpers/tests/garnet-persistence_test.ts | 12 +- 5 files changed, 220 insertions(+), 200 deletions(-) diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md index e11919afae..5eaea23582 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md @@ -7,3 +7,5 @@ Red baseline proved before source modification: no-path3pass; DataPath3missing-A Implementation and generated consumers complete:33/33 generator/persistence tests pass, including actual hard-container-restart AOF-only and checkpoint+AOF-tail job delivery. Scoped static/quality/preflight/accuracy/JSR/doc-lint/freshness gates pass (CLI doc lint zero base/head,25 existing JSR warnings). Supported final source-head full workflow43940698080 succeeds for Postgres, SQLite, static and native. Local one-pass partial due unavailable local Docker/Postgres, cleanup passes, ownership preview zero owned commands. Source head3ab21381d unchanged by evidence-only followup. Four issue boxes checked with linked IMPL proof; closing keyword/evidence block in body. Final independent straightforward IMPL-EVAL is required; retain draft until PASS and current required checks green/policy-skipped. Independent IMPL-EVAL PASS at1e16cc31d, comment6927774411; no blocking findings. evaluate.md retained. Ready transition and final required-head check/thread verification next. No product source changes since supported green source head3ab21381d. + +Ready-for-review quality:cli required canonical formatting on the changed generator. Legacy-style decision superseded. Owned generator is now canonically normalized, verified exactly equal to canonical formatter output of evaluated source. Test adds deterministic20-second readiness/phase diagnostics after a transient pre-delivery boot failure; actual recovery delivery oracle unchanged. All33runtime/generator tests and full quality:cli pass. Need independent follow-up for this delta, then final current head checks. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md index b2a7d695a4..6e25d81f7e 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/drift.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/drift.md @@ -5,3 +5,8 @@ rtk/rg absent; direct commands run as node. Pinned Deno2.9.7 via mise. Current m - Runtime research found a pinned native checkpoint alignment failure before any generator change. Original checkpoint probe failure is excluded as proof of the reported missing-AOF finding. Added an AOF-only restart oracle to isolate data loss. Durable launch policy now includes FileStream plus storage-tier, following the confirmed upstream configuration workaround for4K-sector storage, with both directories sharing the configured data path. This is native provider configuration within the existing contract; no version bump or unsupported scheduler. - Preserved the existing semicolon-free generator style rather than adding broad mechanical punctuation churn. Structured formatting uses CLI quality settings with the sole per-file temporary semicolon override, measured passing on base and head; the new test uses canonical CLI settings. No shared formatter changes. + + +## Required CI formatter correction + +Required ready-for-review quality:cli compares changed files against canonical CLI style and rejected the legacy-style generator. This supersedes the earlier temporary-config decision; that decision was insufficient for the required gate. Canonically format only the owned generator. Formatting the evaluated source through the canonical formatter yields exactly the current file, proving the generator delta is formatter-only. No launch policy changes. A repeated live test exposed a readiness-window fixture failure (connection refused before delivery assertions), so readiness now has deterministic20seconds instead of jittered ~5seconds and reports its phase; hard-restart delivery still has its original5-second bound. All33tests pass again and full quality:cli passes. No repo formatter policy edits, no gate waiver. Independent follow-up evaluation required. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index bdb94478b6..2f8f2b6e7b 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -50,3 +50,8 @@ Final full scaffold.runtime one-pass local command exits1: documented-scaffold P ## Independent implementation verdict [Separate-session IMPL-EVAL PASS](https://github.com/rickylabs/netscript/pull/2643#issuecomment-6927774411) at1e16cc31d. GLM5.3Flash/provider-default matches pinned primary and is independent from OpenAI generator. Evaluator independently executes33/33 live generator/persistence tests, verifies pinned flags, scoped typecheck47files, quality, preflight, docs accuracy, doc lint zero, JSR audit/dry-run and supported full smoke source invariance. No blocking findings; only existing sibling format drift and non-blocking CI annotation. Owned resource scan empty. Final evidence-only verdict commit precedes ready-for-review transition; verify current required checks and review threads after transition. + + +## Required head-check repair + +Ready transition exposed required quality:cli formatting failure on the touched generator. Canonical normalization is necessary; earlier legacy-style justification is superseded (see drift.md). Canonical formatter output of the evaluated generator equals the current generator exactly. Only the existing generator is normalized; CLI-wide baseline drift is untouched. quality:cli passes canonical lint1289files/fmt1164files. Combined generator/persistence suite33/33 passes with deterministic20-second PING readiness and failure-phase diagnostics. One preceding connection-refused readiness failure is recorded as fixture/bootstrap evidence, not a durability verdict. Enqueue/hard restart/delivery/ack assertions and5-second delivery bound unchanged. Supported full runtime remains valid at semantically identical generated output; no expensive smoke repeat for formatter-only delta. Final evaluator follow-up will verify this narrowly. diff --git a/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts b/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts index 86146eb91d..6595f36ddb 100644 --- a/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts +++ b/packages/cli/src/kernel/templates/aspire/helpers/register/generate-register-infrastructure.ts @@ -7,31 +7,31 @@ * resource resolution. */ -import type { CacheEntry } from '@netscript/aspire/types' -import type { RegisterInfrastructureOptions } from '../types.ts' -import { fileHeader } from '../_utils.ts' -import { SCAFFOLD_ASPIRE_MODULES } from '../../../../constants/scaffold/scaffold-aspire.ts' -import { SCAFFOLD_VERSIONS } from '../../../../constants/scaffold/scaffold-versions.ts' -import { SCAFFOLD_CACHE_CONTAINER_IMAGES } from '../../../../constants/scaffold/scaffold-container-images.ts' -import { TEMPLATE_KEYS } from '../../../../assets/manifest.ts' -import { renderTemplateAssetSync } from '../../../../adapters/templates/template-asset.ts' +import type { CacheEntry } from '@netscript/aspire/types'; +import type { RegisterInfrastructureOptions } from '../types.ts'; +import { fileHeader } from '../_utils.ts'; +import { SCAFFOLD_ASPIRE_MODULES } from '../../../../constants/scaffold/scaffold-aspire.ts'; +import { SCAFFOLD_VERSIONS } from '../../../../constants/scaffold/scaffold-versions.ts'; +import { SCAFFOLD_CACHE_CONTAINER_IMAGES } from '../../../../constants/scaffold/scaffold-container-images.ts'; +import { TEMPLATE_KEYS } from '../../../../assets/manifest.ts'; +import { renderTemplateAssetSync } from '../../../../adapters/templates/template-asset.ts'; /** Maps database engine names to SDK builder method names. */ const DB_ENGINE_METHODS: Record = { Postgres: 'addPostgres', Mysql: 'addMySql', Mssql: 'addSqlServer', -} +}; -const MSSQL_CONTAINER_IMAGE = 'mssql/server' -const MSSQL_CONTAINER_TAG = '2022-latest' -const MSSQL_SA_PASSWORD = 'NetscriptE2e!Sql2026' +const MSSQL_CONTAINER_IMAGE = 'mssql/server'; +const MSSQL_CONTAINER_TAG = '2022-latest'; +const MSSQL_SA_PASSWORD = 'NetscriptE2e!Sql2026'; /** Redis-compatible TCP port inside cache containers. */ -const CACHE_DEFAULT_PORT = 6379 +const CACHE_DEFAULT_PORT = 6379; /** Queue receipts require atomic Lua in every managed Garnet launch mode. */ -const GARNET_LEASE_ARGS = ['--lua', '--lua-transaction-mode'] as const +const GARNET_LEASE_ARGS = ['--lua', '--lua-transaction-mode'] as const; /** DataPath opts into recoverable writes and portable checkpoint/device alignment. */ const GARNET_PERSISTENCE_ARGS = [ @@ -43,16 +43,16 @@ const GARNET_PERSISTENCE_ARGS = [ '--storage-tier', '--device-type', 'FileStream', -] as const +] as const; /** Deno KV Connect container image (shared KV over HTTP). */ const DENOKV_CONTAINER = { image: 'ghcr.io/denoland/denokv', tag: '0.11.0', -} as const +} as const; /** Deno KV Connect HTTP port inside the container. */ -const DENOKV_HTTP_PORT = 4512 +const DENOKV_HTTP_PORT = 4512; /** * Generates the register-infrastructure.mts file content. @@ -63,35 +63,35 @@ const DENOKV_HTTP_PORT = 4512 export function generateRegisterInfrastructure( options: RegisterInfrastructureOptions, ): string { - const { databases, caches, primaryDatabase, primaryCache } = options - const dbEntries = Object.entries(databases) - const cacheEntries = Object.entries(caches) + const { databases, caches, primaryDatabase, primaryCache } = options; + const dbEntries = Object.entries(databases); + const cacheEntries = Object.entries(caches); const usesDenoKvContainer = cacheEntries.some(([, entry]) => entry.Engine === 'DenoKv' && !['External', 'Local'].includes(entry.Mode ?? 'Container') - ) + ); const hasPersistentContainerDatabase = dbEntries.some(([, entry]) => entry.Engine !== 'Sqlite' && (entry.Mode ?? 'Container') === 'Container' && entry.Persistent === true - ) + ); const usesDatabaseListenerReadiness = dbEntries.some(([, entry]) => ['Postgres', 'Mysql', 'Mssql'].includes(entry.Engine) && (entry.Mode ?? 'Container') === 'Container' - ) + ); const usesPostgresCredentialReadiness = dbEntries.some(([, entry]) => needsPostgresCredentialReadiness(entry) - ) + ); const usesRespReadiness = cacheEntries.some(([, entry]) => ['Redis', 'Garnet'].includes(entry.Engine) && !['External', 'Local'].includes(entry.Mode ?? 'Container') - ) + ); const sdkValueImports = [ ...(hasPersistentContainerDatabase ? ['ContainerLifetime'] : []), ...(cacheEntries.some(([, entry]) => !['External', 'Local'].includes(entry.Mode ?? 'Container')) ? ['EndpointProperty'] : []), - ] + ]; const compatImports = [ 'type CacheWiring', ...(usesDatabaseListenerReadiness ? ['createEndpointListenerReadinessCheck'] : []), @@ -112,23 +112,23 @@ export function generateRegisterInfrastructure( ...(usesDenoKvContainer ? ['generateAccessToken as _generateAccessToken'] : []), ...(usesResolvedDataPath(dbEntries, cacheEntries) ? ['resolveDataPath'] : []), ...(cacheEntries.some(([, entry]) => entry.Mode === 'Auto') ? ['shouldUseContainerCache'] : []), - ] + ]; // Build database registration blocks - const dbBlocks: string[] = [] + const dbBlocks: string[] = []; for (const [databaseIndex, [name, entry]] of dbEntries.entries()) { - const id = `db_${databaseIndex}` - const mode = entry.Mode ?? 'Container' + const id = `db_${databaseIndex}`; + const mode = entry.Mode ?? 'Container'; if (entry.Engine === 'Sqlite') { - const sqlitePath = entry.DataPath ?? entry.DatabaseName ?? `${name}.sqlite` + const sqlitePath = entry.DataPath ?? entry.DatabaseName ?? `${name}.sqlite`; dbBlocks.push(` // database ${databaseIndex} (Sqlite, resolved file-backed resource) const ${id} = await builder.addParameter(${JSON.stringify(name)}, { value: resolveDataPath(appHostDir, ${JSON.stringify(sqlitePath)}, ${JSON.stringify(name)}), secret: false, }); - databases.set(${JSON.stringify(name)}, ${id});`) - continue + databases.set(${JSON.stringify(name)}, ${id});`); + continue; } if (mode === 'External') { @@ -138,14 +138,14 @@ export function generateRegisterInfrastructure( databaseConnectionStrings.set( ${JSON.stringify(name)}, async () => await builder.getConfiguration().getConnectionString(${JSON.stringify(name)}), - );`) - continue + );`); + continue; } - const method = DB_ENGINE_METHODS[entry.Engine] ?? 'addConnectionString' - const lines: string[] = [] + const method = DB_ENGINE_METHODS[entry.Engine] ?? 'addConnectionString'; + const lines: string[] = []; - lines.push(` // database ${databaseIndex} (Container)`) + lines.push(` // database ${databaseIndex} (Container)`); // TypeScript Aspire SDK: every `builder.addXxx(...)` and `.addDatabase(...)` // returns a ResourcePromise. The chained configuration methods // (`withLifetime`, `withDataBindMount`, …) are defined on the promise, @@ -159,103 +159,103 @@ export function generateRegisterInfrastructure( ` const ${id}_password_value = ensureDatabasePassword(appHostDir, ${ JSON.stringify(name) });`, - ) + ); lines.push( ` const ${id}_password = await builder.addParameter(${ JSON.stringify(`${name}-password`) }, {`, - ) - lines.push(` value: ${id}_password_value,`) - lines.push(` secret: true,`) - lines.push(` });`) - lines.push(` const ${id}_server = await builder.${method}(${JSON.stringify(name)}, {`) + ); + lines.push(` value: ${id}_password_value,`); + lines.push(` secret: true,`); + lines.push(` });`); + lines.push(` const ${id}_server = await builder.${method}(${JSON.stringify(name)}, {`); if (entry.Port !== undefined) { - lines.push(` port: ${entry.Port},`) + lines.push(` port: ${entry.Port},`); } - lines.push(` password: ${id}_password,`) - lines.push(` })`) + lines.push(` password: ${id}_password,`); + lines.push(` })`); } else if (entry.Engine === 'Mssql') { lines.push( ` const ${id}_password = await builder.addParameter(${ JSON.stringify(`${name}-password`) }, {`, - ) - lines.push(` value: '${MSSQL_SA_PASSWORD}',`) - lines.push(` secret: true,`) - lines.push(` });`) - lines.push(` const ${id}_server = await builder.${method}(${JSON.stringify(name)}, {`) + ); + lines.push(` value: '${MSSQL_SA_PASSWORD}',`); + lines.push(` secret: true,`); + lines.push(` });`); + lines.push(` const ${id}_server = await builder.${method}(${JSON.stringify(name)}, {`); if (entry.Port !== undefined) { - lines.push(` port: ${entry.Port},`) + lines.push(` port: ${entry.Port},`); } - lines.push(` password: ${id}_password,`) - lines.push(` })`) + lines.push(` password: ${id}_password,`); + lines.push(` })`); } else { - lines.push(` const ${id}_server = await builder.${method}(${JSON.stringify(name)})`) + lines.push(` const ${id}_server = await builder.${method}(${JSON.stringify(name)})`); } if (entry.Persistent) { lines.push( ` // Isolated starts randomize ports, so a configured-persistent container must remain session-scoped.`, - ) + ); lines.push( ` .withLifetime(isolatedStart ? ContainerLifetime.Session : ContainerLifetime.Persistent)`, - ) + ); } if (entry.DataPath) { lines.push( ` .withDataBindMount(resolveDataPath(appHostDir, ${JSON.stringify(entry.DataPath)}, ${ JSON.stringify(name) }))`, - ) + ); } if (entry.Engine === 'Mssql') { - lines.push(` .withImage('${MSSQL_CONTAINER_IMAGE}')`) + lines.push(` .withImage('${MSSQL_CONTAINER_IMAGE}')`); lines.push( ` .withImageTag(${JSON.stringify(entry.ImageTag ?? MSSQL_CONTAINER_TAG)})`, - ) - lines.push(` .withEnvironment('ACCEPT_EULA', 'Y')`) - lines.push(` .withEnvironment('SA_PASSWORD', '${MSSQL_SA_PASSWORD}')`) + ); + lines.push(` .withEnvironment('ACCEPT_EULA', 'Y')`); + lines.push(` .withEnvironment('SA_PASSWORD', '${MSSQL_SA_PASSWORD}')`); lines.push( ` .withEnvironment('MSSQL_SA_PASSWORD', '${MSSQL_SA_PASSWORD}')`, - ) + ); } // Close the server chain with semicolon - const lastIdx = lines.length - 1 - lines[lastIdx] = lines[lastIdx] + ';' + const lastIdx = lines.length - 1; + lines[lastIdx] = lines[lastIdx] + ';'; if (['Postgres', 'Mysql', 'Mssql'].includes(entry.Engine)) { - const healthCheckKey = `${name}_listener` - lines.push(` builder.addHealthCheck(${JSON.stringify(healthCheckKey)}, async () => {`) - lines.push(` return await createEndpointListenerReadinessCheck({`) - lines.push(` kind: ${JSON.stringify(entry.Engine.toLowerCase())},`) - lines.push(` endpoint: () => ${id}_server.getEndpoint('tcp'),`) - lines.push(` })();`) - lines.push(` });`) - lines.push(` await ${id}_server.withHealthCheck(${JSON.stringify(healthCheckKey)});`) + const healthCheckKey = `${name}_listener`; + lines.push(` builder.addHealthCheck(${JSON.stringify(healthCheckKey)}, async () => {`); + lines.push(` return await createEndpointListenerReadinessCheck({`); + lines.push(` kind: ${JSON.stringify(entry.Engine.toLowerCase())},`); + lines.push(` endpoint: () => ${id}_server.getEndpoint('tcp'),`); + lines.push(` })();`); + lines.push(` });`); + lines.push(` await ${id}_server.withHealthCheck(${JSON.stringify(healthCheckKey)});`); } if (needsPostgresCredentialReadiness(entry)) { - appendPostgresCredentialReadinessLines(lines, id, name) + appendPostgresCredentialReadinessLines(lines, id, name); } // Add database child resource if DatabaseName is specified if (entry.DatabaseName) { lines.push( ` const ${id} = await ${id}_server.addDatabase(${JSON.stringify(entry.DatabaseName)});`, - ) + ); } else { - lines.push(` const ${id} = ${id}_server;`) + lines.push(` const ${id} = ${id}_server;`); } - lines.push(` databases.set(${JSON.stringify(name)}, ${id});`) - dbBlocks.push(lines.join('\n')) + lines.push(` databases.set(${JSON.stringify(name)}, ${id});`); + dbBlocks.push(lines.join('\n')); } // Build cache registration blocks - const cacheBlocks: string[] = [] + const cacheBlocks: string[] = []; for (const [cacheIndex, [name, entry]] of cacheEntries.entries()) { - const id = `cache_${cacheIndex}` - const mode = entry.Mode ?? 'Container' + const id = `cache_${cacheIndex}`; + const mode = entry.Mode ?? 'Container'; // DenoKv Local — in-process Deno.openKv(), no Aspire resource. if (entry.Engine === 'DenoKv' && mode === 'Local') { @@ -264,8 +264,8 @@ export function generateRegisterInfrastructure( ` cacheWiring.set(${ JSON.stringify(name) }, { resource: null, reference: null, env: {}, local: true });`, - ) - continue + ); + continue; } // External — connection-string resource; consumer wires by reference only. @@ -275,8 +275,8 @@ export function generateRegisterInfrastructure( caches.set(${JSON.stringify(name)}, ${id}); cacheWiring.set(${ JSON.stringify(name) - }, { resource: ${id}, reference: ${id}, env: {}, local: false });`) - continue + }, { resource: ${id}, reference: ${id}, env: {}, local: false });`); + continue; } // Auto — environment-aware at apphost runtime (D5/D6). Docker present → @@ -288,73 +288,73 @@ export function generateRegisterInfrastructure( if (mode === 'Auto') { const container = entry.Engine === 'DenoKv' ? denokvContainerSetup(id, name, entry) - : redisGarnetContainerSetup(id, name, entry) - const executable = garnetExecutableSetup(id, name, entry) - const lines: string[] = [] + : redisGarnetContainerSetup(id, name, entry); + const executable = garnetExecutableSetup(id, name, entry); + const lines: string[] = []; lines.push( ` // cache ${cacheIndex} (Auto — Docker container; Docker-less Garnet executable)`, - ) - lines.push(` let ${id}_wiring: CacheWiring;`) - lines.push(` if (shouldUseContainerCache()) {`) - for (const line of container.lines) lines.push(` ${line}`) - lines.push(` ${id}_wiring = ${container.wiring};`) - lines.push(` } else {`) - for (const line of executable.lines) lines.push(` ${line}`) - lines.push(` ${id}_wiring = ${executable.wiring};`) - lines.push(` }`) - lines.push(` cacheWiring.set(${JSON.stringify(name)}, ${id}_wiring);`) - cacheBlocks.push(lines.join('\n')) - continue + ); + lines.push(` let ${id}_wiring: CacheWiring;`); + lines.push(` if (shouldUseContainerCache()) {`); + for (const line of container.lines) lines.push(` ${line}`); + lines.push(` ${id}_wiring = ${container.wiring};`); + lines.push(` } else {`); + for (const line of executable.lines) lines.push(` ${line}`); + lines.push(` ${id}_wiring = ${executable.wiring};`); + lines.push(` }`); + lines.push(` cacheWiring.set(${JSON.stringify(name)}, ${id}_wiring);`); + cacheBlocks.push(lines.join('\n')); + continue; } // DenoKv Container — Deno KV Connect over HTTP with an access token. if (entry.Engine === 'DenoKv') { - const setup = denokvContainerSetup(id, name, entry) + const setup = denokvContainerSetup(id, name, entry); const lines = [ ` // cache ${cacheIndex} (DenoKv, Container — Deno KV Connect)`, ...setup.lines, ` cacheWiring.set(${JSON.stringify(name)}, ${setup.wiring});`, - ] - cacheBlocks.push(lines.join('\n')) - continue + ]; + cacheBlocks.push(lines.join('\n')); + continue; } // Garnet Executable — Docker-less self-provisioned dotnet tool (#372). if (entry.Engine === 'Garnet' && mode === 'Executable') { - const setup = garnetExecutableSetup(id, name, entry) + const setup = garnetExecutableSetup(id, name, entry); const lines = [ ` // cache ${cacheIndex} (Garnet, Executable — Docker-less dotnet tool)`, ...setup.lines, ` cacheWiring.set(${JSON.stringify(name)}, ${setup.wiring});`, - ] - cacheBlocks.push(lines.join('\n')) - continue + ]; + cacheBlocks.push(lines.join('\n')); + continue; } // Redis / Garnet Container — Redis-compatible TCP endpoint. - const setup = redisGarnetContainerSetup(id, name, entry) + const setup = redisGarnetContainerSetup(id, name, entry); const lines = [ ` // cache ${cacheIndex} (Container)`, ...setup.lines, ` cacheWiring.set(${JSON.stringify(name)}, ${setup.wiring});`, - ] - cacheBlocks.push(lines.join('\n')) + ]; + cacheBlocks.push(lines.join('\n')); } // Primary resolution const primaryDbLine = primaryDatabase ? ` const primaryDatabase = databases.get(${JSON.stringify(primaryDatabase)}) ?? null;` - : ` const primaryDatabase = null;` + : ` const primaryDatabase = null;`; const primaryCacheLine = primaryCache ? ` const primaryCache = caches.get(${JSON.stringify(primaryCache)}) ?? null;` - : ` const primaryCache = null;` + : ` const primaryCache = null;`; const primaryCacheEndpointLine = primaryCache ? ` const primaryCacheEndpoint = cacheEndpoints.get(${JSON.stringify(primaryCache)}) ?? null;` - : ` const primaryCacheEndpoint = null;` + : ` const primaryCacheEndpoint = null;`; const primaryCacheWiringLine = primaryCache ? ` const primaryCacheWiring = cacheWiring.get(${JSON.stringify(primaryCache)}) ?? null;` - : ` const primaryCacheWiring = null;` + : ` const primaryCacheWiring = null;`; return renderTemplateAssetSync( TEMPLATE_KEYS.generatedAspireHelpersGenerateRegisterInfrastructure1, @@ -390,13 +390,13 @@ export function generateRegisterInfrastructure( : '', ), }, - ) + ); } function needsPostgresCredentialReadiness( entry: RegisterInfrastructureOptions['databases'][string], ): boolean { - return entry.Engine === 'Postgres' && (entry.Mode ?? 'Container') === 'Container' + return entry.Engine === 'Postgres' && (entry.Mode ?? 'Container') === 'Container'; } function usesResolvedDataPath( @@ -409,7 +409,7 @@ function usesResolvedDataPath( ) || cacheEntries.some(([, entry]) => entry.DataPath !== undefined && !['External', 'Local'].includes(entry.Mode ?? 'Container') - ) + ); } /** @@ -423,39 +423,39 @@ function denokvContainerSetup( name: string, entry: CacheEntry, ): { lines: string[]; wiring: string } { - const tag = entry.ImageTag ?? DENOKV_CONTAINER.tag - const imageRef = `${DENOKV_CONTAINER.image}:${tag}` - const lines: string[] = [] + const tag = entry.ImageTag ?? DENOKV_CONTAINER.tag; + const imageRef = `${DENOKV_CONTAINER.image}:${tag}`; + const lines: string[] = []; - lines.push(` const ${id}_token = _generateAccessToken();`) + lines.push(` const ${id}_token = _generateAccessToken();`); lines.push( ` const ${id} = await builder.addContainer(${JSON.stringify(name)}, ${ JSON.stringify(imageRef) })`, - ) + ); lines.push( ` .withEndpoint({ name: 'http', targetPort: ${DENOKV_HTTP_PORT}, scheme: 'http' })`, - ) - lines.push(` .withContainerRuntimeArgs(['--init'])`) - lines.push(` .withArgs(['--sqlite-path', '/data/denokv.sqlite', 'serve'])`) - lines.push(` .withEnvironment('DENO_KV_ACCESS_TOKEN', ${id}_token)`) + ); + lines.push(` .withContainerRuntimeArgs(['--init'])`); + lines.push(` .withArgs(['--sqlite-path', '/data/denokv.sqlite', 'serve'])`); + lines.push(` .withEnvironment('DENO_KV_ACCESS_TOKEN', ${id}_token)`); if (entry.DataPath) { lines.push( ` .withBindMount(resolveDataPath(appHostDir, ${JSON.stringify(entry.DataPath)}, ${ JSON.stringify(name) }), '/data')`, - ) + ); } - const lastIdx = lines.length - 1 - lines[lastIdx] = lines[lastIdx] + ';' + const lastIdx = lines.length - 1; + lines[lastIdx] = lines[lastIdx] + ';'; - lines.push(` const ${id}_httpEndpoint = await ${id}.getEndpoint('http');`) + lines.push(` const ${id}_httpEndpoint = await ${id}.getEndpoint('http');`); lines.push( ` const ${id}_httpUrl = ${id}_httpEndpoint.property(EndpointProperty.Url);`, - ) - lines.push(` caches.set(${JSON.stringify(name)}, ${id});`) - lines.push(` cacheEndpoints.set(${JSON.stringify(name)}, ${id}_httpEndpoint);`) + ); + lines.push(` caches.set(${JSON.stringify(name)}, ${id});`); + lines.push(` cacheEndpoints.set(${JSON.stringify(name)}, ${id}_httpEndpoint);`); // DENO_KV_URL is injected explicitly (scheme-complete, via EndpointProperty.Url) // so the consumer's autoDetectProvider() resolves the KV Connect URL from an env @@ -464,8 +464,8 @@ function denokvContainerSetup( // resource is literally named 'kv' (services__kv__http__0), silently falling back // to in-process Deno.openKv() otherwise. const wiring = - `{ resource: ${id}, reference: ${id}_httpEndpoint, env: { DENO_KV_URL: ${id}_httpUrl, DENO_KV_ACCESS_TOKEN: ${id}_token, CACHE_PROVIDER: 'denokv' }, local: false }` - return { lines, wiring } + `{ resource: ${id}, reference: ${id}_httpEndpoint, env: { DENO_KV_URL: ${id}_httpUrl, DENO_KV_ACCESS_TOKEN: ${id}_token, CACHE_PROVIDER: 'denokv' }, local: false }`; + return { lines, wiring }; } /** @@ -479,55 +479,55 @@ function garnetExecutableSetup( name: string, entry: CacheEntry, ): { lines: string[]; wiring: string } { - const version = entry.ToolVersion ?? SCAFFOLD_VERSIONS.GARNET_TOOL - const lines: string[] = [] + const version = entry.ToolVersion ?? SCAFFOLD_VERSIONS.GARNET_TOOL; + const lines: string[] = []; lines.push( ` const ${id}_workdir = ensureGarnetToolManifest(appHostDir, ${JSON.stringify(version)});`, - ) + ); if (entry.DataPath) { lines.push( ` const ${id}_dataPath = resolveDataPath(appHostDir, ${JSON.stringify(entry.DataPath)}, ${ JSON.stringify(name) });`, - ) + ); } lines.push( ` const ${id} = await builder.addExecutable(${ JSON.stringify(name) }, 'dotnet', ${id}_workdir, ['tool', 'run', 'garnet-server'])`, - ) + ); lines.push( ` .withEndpoint(${cacheExecutableEndpointOptions(entry.Port)});`, - ) - lines.push(` const ${id}_tcpEndpoint = await ${id}.getEndpoint('tcp');`) - lines.push(` await ${id}.withArgsCallback(async (context) => {`) - lines.push(` const args = await context.args();`) - lines.push(` await args.add('--port');`) - lines.push(` await args.add(${id}_tcpEndpoint.property(EndpointProperty.TargetPort));`) - const args = [...GARNET_LEASE_ARGS, ...(entry.DataPath ? GARNET_PERSISTENCE_ARGS : [])] + ); + lines.push(` const ${id}_tcpEndpoint = await ${id}.getEndpoint('tcp');`); + lines.push(` await ${id}.withArgsCallback(async (context) => {`); + lines.push(` const args = await context.args();`); + lines.push(` await args.add('--port');`); + lines.push(` await args.add(${id}_tcpEndpoint.property(EndpointProperty.TargetPort));`); + const args = [...GARNET_LEASE_ARGS, ...(entry.DataPath ? GARNET_PERSISTENCE_ARGS : [])]; for (const arg of args) { - lines.push(` await args.add(${JSON.stringify(arg)});`) + lines.push(` await args.add(${JSON.stringify(arg)});`); } if (entry.DataPath) { for (const flag of ['--logdir', '--checkpointdir']) { - lines.push(` await args.add(${JSON.stringify(flag)});`) - lines.push(` await args.add(${id}_dataPath);`) + lines.push(` await args.add(${JSON.stringify(flag)});`); + lines.push(` await args.add(${id}_dataPath);`); } } - lines.push(` });`) + lines.push(` });`); lines.push( ` const ${id}_hostPort = ${id}_tcpEndpoint.property(EndpointProperty.HostAndPort);`, - ) + ); if (['Redis', 'Garnet'].includes(entry.Engine)) { - appendRespReadinessLines(lines, id, name) + appendRespReadinessLines(lines, id, name); } - lines.push(` caches.set(${JSON.stringify(name)}, ${id});`) - lines.push(` cacheEndpoints.set(${JSON.stringify(name)}, ${id}_tcpEndpoint);`) + lines.push(` caches.set(${JSON.stringify(name)}, ${id});`); + lines.push(` cacheEndpoints.set(${JSON.stringify(name)}, ${id}_tcpEndpoint);`); const wiring = - `{ resource: ${id}, reference: ${id}_tcpEndpoint, env: { GARNET_URI: ${id}_hostPort, REDIS_URI: ${id}_hostPort, CACHE_PROVIDER: 'garnet' }, local: false }` - return { lines, wiring } + `{ resource: ${id}, reference: ${id}_tcpEndpoint, env: { GARNET_URI: ${id}_hostPort, REDIS_URI: ${id}_hostPort, CACHE_PROVIDER: 'garnet' }, local: false }`; + return { lines, wiring }; } /** @@ -541,18 +541,18 @@ function redisGarnetContainerSetup( entry: CacheEntry, ): { lines: string[]; wiring: string } { const image = SCAFFOLD_CACHE_CONTAINER_IMAGES[entry.Engine] ?? - SCAFFOLD_CACHE_CONTAINER_IMAGES.Redis - const tag = entry.ImageTag ?? image.tag - const imageRef = `${image.image}:${tag}` - const provider = entry.Engine === 'Garnet' ? 'garnet' : 'redis' - const lines: string[] = [] + SCAFFOLD_CACHE_CONTAINER_IMAGES.Redis; + const tag = entry.ImageTag ?? image.tag; + const imageRef = `${image.image}:${tag}`; + const provider = entry.Engine === 'Garnet' ? 'garnet' : 'redis'; + const lines: string[] = []; lines.push( ` const ${id} = await builder.addContainer(${JSON.stringify(name)}, ${ JSON.stringify(imageRef) })`, - ) - lines.push(` .withEndpoint(${cacheEndpointOptions(entry.Port)})`) + ); + lines.push(` .withEndpoint(${cacheEndpointOptions(entry.Port)})`); if (entry.Engine === 'Garnet') { const args = entry.DataPath ? [ @@ -563,35 +563,35 @@ function redisGarnetContainerSetup( '--checkpointdir', '/data', ] - : GARNET_LEASE_ARGS - lines.push(` .withArgs(${JSON.stringify(args)})`) + : GARNET_LEASE_ARGS; + lines.push(` .withArgs(${JSON.stringify(args)})`); } if (entry.DataPath) { lines.push( ` .withBindMount(resolveDataPath(appHostDir, ${JSON.stringify(entry.DataPath)}, ${ JSON.stringify(name) }), '/data')`, - ) + ); } - const lastIdx = lines.length - 1 - lines[lastIdx] = lines[lastIdx] + ';' + const lastIdx = lines.length - 1; + lines[lastIdx] = lines[lastIdx] + ';'; - lines.push(` const ${id}_tcpEndpoint = await ${id}.getEndpoint('tcp');`) + lines.push(` const ${id}_tcpEndpoint = await ${id}.getEndpoint('tcp');`); lines.push( ` const ${id}_hostPort = ${id}_tcpEndpoint.property(EndpointProperty.HostAndPort);`, - ) + ); if (['Redis', 'Garnet'].includes(entry.Engine)) { - appendRespReadinessLines(lines, id, name) + appendRespReadinessLines(lines, id, name); } - lines.push(` caches.set(${JSON.stringify(name)}, ${id});`) - lines.push(` cacheEndpoints.set(${JSON.stringify(name)}, ${id}_tcpEndpoint);`) + lines.push(` caches.set(${JSON.stringify(name)}, ${id});`); + lines.push(` cacheEndpoints.set(${JSON.stringify(name)}, ${id}_tcpEndpoint);`); const wiring = `{ resource: ${id}, reference: ${id}_tcpEndpoint, env: { GARNET_URI: ${id}_hostPort, REDIS_URI: ${id}_hostPort, CACHE_PROVIDER: ${ JSON.stringify(provider) - } }, local: false }` - return { lines, wiring } + } }, local: false }`; + return { lines, wiring }; } /** @@ -601,27 +601,27 @@ function redisGarnetContainerSetup( * Aspire 13.5.3 rejects `ReferenceExpression.getValue()` inside AppHost callbacks. */ function appendPostgresCredentialReadinessLines(lines: string[], id: string, name: string): void { - const healthCheckKey = `${name}_auth` + const healthCheckKey = `${name}_auth`; lines.push( ` builder.addHealthCheck(${ JSON.stringify(healthCheckKey) }, createPostgresCredentialReadinessCheck({`, - ) - lines.push(` endpoint: () => ${id}_server.getEndpoint('tcp'),`) - lines.push(` password: ${id}_password_value,`) - lines.push(` }));`) - lines.push(` await ${id}_server.withHealthCheck(${JSON.stringify(healthCheckKey)});`) + ); + lines.push(` endpoint: () => ${id}_server.getEndpoint('tcp'),`); + lines.push(` password: ${id}_password_value,`); + lines.push(` }));`); + lines.push(` await ${id}_server.withHealthCheck(${JSON.stringify(healthCheckKey)});`); } function appendRespReadinessLines(lines: string[], id: string, name: string): void { - const healthCheckKey = `${name}_resp` - lines.push(` builder.addHealthCheck(${JSON.stringify(healthCheckKey)}, async () => {`) - lines.push(` const endpoint = await ${id}.getEndpoint('tcp');`) - lines.push(` const host = await endpoint.host();`) - lines.push(` const port = await endpoint.port();`) - lines.push(` return createRespPingCheck({ host, port })();`) - lines.push(` });`) - lines.push(` await ${id}.withHealthCheck(${JSON.stringify(healthCheckKey)});`) + const healthCheckKey = `${name}_resp`; + lines.push(` builder.addHealthCheck(${JSON.stringify(healthCheckKey)}, async () => {`); + lines.push(` const endpoint = await ${id}.getEndpoint('tcp');`); + lines.push(` const host = await endpoint.host();`); + lines.push(` const port = await endpoint.port();`); + lines.push(` return createRespPingCheck({ host, port })();`); + lines.push(` });`); + lines.push(` await ${id}.withHealthCheck(${JSON.stringify(healthCheckKey)});`); } function cacheEndpointOptions(port: number | undefined): string { @@ -629,18 +629,18 @@ function cacheEndpointOptions(port: number | undefined): string { "name: 'tcp'", `targetPort: ${CACHE_DEFAULT_PORT}`, "scheme: 'tcp'", - ] + ]; if (port !== undefined) { - options.unshift(`port: ${port}`) + options.unshift(`port: ${port}`); } - return `{ ${options.join(', ')} }` + return `{ ${options.join(', ')} }`; } /** Executable target ports are allocated per run; Port only opts into a host proxy pin. */ function cacheExecutableEndpointOptions(port: number | undefined): string { - const options = ["name: 'tcp'", "scheme: 'tcp'"] + const options = ["name: 'tcp'", "scheme: 'tcp'"]; if (port !== undefined) { - options.unshift(`port: ${port}`) + options.unshift(`port: ${port}`); } - return `{ ${options.join(', ')} }` + return `{ ${options.join(', ')} }`; } diff --git a/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts b/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts index 7a99f4caf5..f7e6126d33 100644 --- a/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts +++ b/packages/cli/src/kernel/templates/aspire/helpers/tests/garnet-persistence_test.ts @@ -119,6 +119,7 @@ for (const checkpoint of [false, true]) { let container: string | undefined; let producer: RedisAdapter<{ id: string }> | undefined; let consumer: RedisAdapter<{ id: string }> | undefined; + let phase = 'initial readiness'; try { volume = await docker('volume', 'create', '--label', label); // A uniquely owned volume supplies the same persistent /data boundary as @@ -143,7 +144,7 @@ for (const checkpoint of [false, true]) { const ready = () => retry(async () => { assertEquals(await command(hostname, port, 'PING'), '+PONG'); - }, { maxAttempts: 200, minTimeout: 20, maxTimeout: 50 }); + }, { maxAttempts: 200, minTimeout: 100, maxTimeout: 100, jitter: 0 }); await ready(); const name = `persistence-${owner}`; producer = new RedisAdapter(url, name); @@ -156,10 +157,12 @@ for (const checkpoint of [false, true]) { await docker('kill', '--signal', 'KILL', container); await producer.stop(); await docker('start', container); + phase = 'restart readiness'; const restartedBinding = (await docker('port', container, '6379/tcp')).split('\n')[0]; port = Number(restartedBinding.slice(restartedBinding.lastIndexOf(':') + 1)); url = `redis://${hostname}:${port}`; await ready(); + phase = 'recovered delivery'; consumer = new RedisAdapter(url, name); const delivered: string[] = []; const controller = new AbortController(); @@ -178,7 +181,12 @@ for (const checkpoint of [false, true]) { assertEquals((await consumer.getHealth()).ready, 0); } catch (cause) { const diagnostic = container ? await docker('logs', container) : 'container not created'; - throw new Error(`Garnet restart probe failed. Server output: ${diagnostic}`, { cause }); + throw new Error( + `Garnet restart probe failed during ${phase}. Server output: ${diagnostic}`, + { + cause, + }, + ); } finally { await consumer?.stop(); await producer?.stop(); From ec80039185f04eeea1c97e33cc888bb713f7f9ce Mon Sep 17 00:00:00 2001 From: Rickylabs Date: Mon, 16 Nov 2026 21:34:04 +0100 Subject: [PATCH 8/8] docs(harness): retain final Garnet evaluation and readiness evidence --- .../context-pack.md | 2 + .../evaluate.md | 54 ++++++++++++++++++- .../worklog.md | 5 ++ 3 files changed, 60 insertions(+), 1 deletion(-) diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md index 5eaea23582..4d4adda319 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/context-pack.md @@ -9,3 +9,5 @@ Implementation and generated consumers complete:33/33 generator/persistence test Independent IMPL-EVAL PASS at1e16cc31d, comment6927774411; no blocking findings. evaluate.md retained. Ready transition and final required-head check/thread verification next. No product source changes since supported green source head3ab21381d. Ready-for-review quality:cli required canonical formatting on the changed generator. Legacy-style decision superseded. Owned generator is now canonically normalized, verified exactly equal to canonical formatter output of evaluated source. Test adds deterministic20-second readiness/phase diagnostics after a transient pre-delivery boot failure; actual recovery delivery oracle unchanged. All33runtime/generator tests and full quality:cli pass. Need independent follow-up for this delta, then final current head checks. + +Cycle2 IMPL-EVAL PASS at7cbcfbd3a, comment6928484888; independent33/33 live tests, canonical equivalence and resource hygiene verified. Required quality green/deps-report policy skip, review threads0/0. Retain verdict artifact, complete body checklist and confirm required checks at final evidence-only head. No merge/ready-merge/publication. diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md b/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md index 59bb0ff943..839dd95e18 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/evaluate.md @@ -123,4 +123,56 @@ consistent with the no-unsupported-timer decision and upstream #2239 alignment w | Field | Value | | --------- | ----- | | Verdict | PASS | -| Rationale | Approved scope fully delivered: DataPath now selects native AOF/recovery, immediate flush acknowledgement, FileStream + storage-tier device configuration, and a shared log/checkpoint directory on every managed Garnet launch arm (Container, Executable, both Auto branches), while no-path launches are byte-identical to the prior Lua/endpoint argv (three no-path controls). Independently verified: 33/33 combined suite including both hard-restart delivery oracles, scoped typecheck, quality:gate, doc lint, JSR dry-run + audit (25 pre-existing warnings), release preflight, docs accuracy, formatter style preservation on changed files, pinned-binary flag existence, zero test-owned Docker residue, no transport/dependency/lock changes, and the supported-runner full smoke SUCCESS at the identical source head. No unrecorded doctrine violations; debt delta zero. Docs accurately describe both durability modes, latency tradeoff, native on-demand checkpoints, and directory retention. | +| Rationale | Cycle 2 re-verification below preserves this cycle 1 PASS. Approved scope fully delivered: DataPath now selects native AOF/recovery, immediate flush acknowledgement, FileStream + storage-tier device configuration, and a shared log/checkpoint directory on every managed Garnet launch arm (Container, Executable, both Auto branches), while no-path launches are byte-identical to the prior Lua/endpoint argv (three no-path controls). Independently verified: 33/33 combined suite including both hard-restart delivery oracles, scoped typecheck, quality:gate, doc lint, JSR dry-run + audit (25 pre-existing warnings), release preflight, docs accuracy, formatter style preservation on changed files, pinned-binary flag existence, zero test-owned Docker residue, no transport/dependency/lock changes, and the supported-runner full smoke SUCCESS at the identical source head. No unrecorded doctrine violations; debt delta zero. Docs accurately describe both durability modes, latency tradeoff, native on-demand checkpoints, and directory retention. | + +--- + +# Cycle 2 (delta re-evaluation) + +## Metadata + +| Field | Value | +| -------------- | ----- | +| Evaluated head | `7cbcfbd3a17e1ddd715c464d589705084ccdf3f6` (branch `fix/garnet-persistence`, worktree clean; base unchanged `origin/main` `b0eb079575968e843b781579673c9fe2ae250e07`) | +| Delta basis | `cf901366b` (head that retained the cycle 1 verdict) → `7cbcfbd3a` | +| Route | Independent fresh evaluator session, `glm_5_3_flash/provider_default` (primary straightforward implementation-evaluation row, no fallback); generator Codex `gpt-6.1-sol/xhigh` (OpenAI family) — different vendor family, different session. Cycle 1 verdict at `1e16cc31d` (comment 6927774411) remains retained. | + +## Delta Scope (independently verified) + +`git diff 1e16cc31d..HEAD --name-status`: exactly two source files plus run artifacts — +`generate-register-infrastructure.ts`, `garnet-persistence_test.ts`, and 4 run-dir files. +No `deno.lock`, dependency, saga-transport, Streams, or doc changes. No tests skipped +(suite reports `ignored:0`). + +| Delta claim | Independent verification | Result | +| ----------- | ------------------------ | ------ | +| Generator change is formatter-only (canonical `.llm/tools/quality/cli-quality.deno.json`) | Evaluator extracted the `cf901366b` generator, ran `deno fmt --config .llm/tools/quality/cli-quality.deno.json` on it, byte-compared to current HEAD: identical (646 → 646 lines, 198 reflowed) | PASS | +| No launch/flags/API change | Byte-identity to the previously evaluated generator proves semantic equivalence of the durable flag composition, no-path argv, and every launch arm | PASS | +| Test readiness is deterministic | `ready()` retry changed from jittered `minTimeout:20/maxTimeout:50` to `maxAttempts:200, minTimeout:100, maxTimeout:100, jitter:0` (bounded 20 s), applied to the pre-existing readiness loop | PASS | +| Failure reports phase | New `phase` variable: `initial readiness` → `restart readiness` → `recovered delivery`, included in the failure diagnostic; informational only | PASS | +| Delivery oracle unchanged | Enqueue (`checkpoint`, `aof-tail`), `getHealth().ready==2`, `kill --signal KILL`, `docker start`, port re-read, post-restart `ready()`, exact `delivered == ['checkpoint','aof-tail']`, ack per message, `ready==0` — all unchanged; 5-second delivery deadline unchanged | PASS | +| Readiness strengthening does not hide data loss | The repeated failure was connection-refused at PING readiness before any delivery assertion (bootstrap/fixture phase). Data loss after restart manifests as a successful PING with zero delivered jobs; the unchanged exact-delivery assertion and 5 s deadline still catch that. A longer readiness wait cannot mask it | PASS | + +## Cycle 2 Gates + +| Gate | Command / evidence | Result | +| ---- | ------------------ | ------ | +| Combined generator + persistence suite (evaluator's own live run) | `DOCKER_HOST= NETSCRIPT_TEST_GARNET_DOCKER=1 deno run --allow-read --allow-write --allow-run .llm/tools/run-deno-test.ts -- --allow-all --unstable-kv …garnet-persistence_test.ts …generate-register-infrastructure_test.ts` (via pinned Deno 2.9.7, structured wrapper) | PASS — exit 0, `passed:33 failed:0 ignored:0`, both real hard-restart delivery oracles executed | +| Test resource hygiene | Evaluator post-run daemon scan: zero containers/volumes bearing the `netscript.test-owner` label; foreign resources untouched | PASS | +| Required `quality` (quality:cli) at current head | CI job 133586872245 (run 43949084683) on head `7cbcfbd3a` — pass | PASS | +| Other required checks at current head | Several check-test shards pending (run still in progress); `deps-report` skipping per policy; close-gate failing solely on the PR body's intentionally unchecked final DoD box (local `check-close-gate.ts --pretty` reproduced: only that box, issue #2636 snapshot clean) | PASS (expected pre-verdict posture; final current-head verification is the generator's post-PASS responsibility) | + +## Cycle 2 Findings + +| Severity | Finding | Action | +| -------- | ------- | ------ | +| none blocking | — | — | +| low (informational) | CLI-wide sibling legacy formatting outside the owned generator remains (unchanged from cycle 1; untouched by this delta) | none | +| low (informational) | Required CI run 43949084683 still in progress (shards pending); close-gate red is solely the pending final DoD box awaiting this verdict | generator post-PASS bookkeeping | + +## Cycle 2 Verdict + +| Field | Value | +| --------- | ----- | +| Verdict | PASS | +| Rationale | The only source delta since the cycle 1 PASS is the required canonical formatting of the owned generator (independently proven byte-identical to the canonical formatter output of the evaluated source — no launch/flag/API change) and a strictly stronger test fixture (deterministic 20-second readiness with phase diagnostics; all durability assertions unchanged). Cycle 1's retained verdict stays valid; the delta is verified green with a fresh independent 33/33 live suite run and zero test-owned residue. Required quality:cli is green at the current head. No blocking findings; the close-gate/DoD/current-head bookkeeping is explicitly post-evaluation and out of this verdict's scope. | diff --git a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md index 2f8f2b6e7b..38de9eb349 100644 --- a/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md +++ b/.llm/runs/fix-garnet-persistence--issue-2636/worklog.md @@ -55,3 +55,8 @@ Final full scaffold.runtime one-pass local command exits1: documented-scaffold P ## Required head-check repair Ready transition exposed required quality:cli formatting failure on the touched generator. Canonical normalization is necessary; earlier legacy-style justification is superseded (see drift.md). Canonical formatter output of the evaluated generator equals the current generator exactly. Only the existing generator is normalized; CLI-wide baseline drift is untouched. quality:cli passes canonical lint1289files/fmt1164files. Combined generator/persistence suite33/33 passes with deterministic20-second PING readiness and failure-phase diagnostics. One preceding connection-refused readiness failure is recorded as fixture/bootstrap evidence, not a durability verdict. Enqueue/hard restart/delivery/ack assertions and5-second delivery bound unchanged. Supported full runtime remains valid at semantically identical generated output; no expensive smoke repeat for formatter-only delta. Final evaluator follow-up will verify this narrowly. + + +## Final independent follow-up + +[Cycle2 IMPL-EVAL PASS](https://github.com/rickylabs/netscript/pull/2643#issuecomment-6928484888) at7cbcfbd3a independently confirms canonical formatter equivalence and33/33live runtime tests, readiness-only fixture change with delivery oracle unchanged, zero owned resource residue. Required quality succeeds at that head; deps-report policy-skipped. Review-thread gate0threads/0unanswered. All issue acceptance and PR completion evidence complete. Verdict-retention commit changes run artifacts only; final required-head checks must be confirmed after push, no source change or extra full smoke.