Skip to content

Commit 1dc0711

Browse files
committed
Release v11.0.0 Adaptive Future Engine
1 parent ec0a34b commit 1dc0711

46 files changed

Lines changed: 4643 additions & 342 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
![DreamGraph](assets/dreamgraph.jpeg)
22

3-
# DreamGraph v10.6.0 — Renata
3+
# DreamGraph v11.0.0 — Adaptive Future Engine
44

5-
![Version](https://img.shields.io/badge/version-10.6.0-blue)
5+
![Version](https://img.shields.io/badge/version-11.0.0-blue)
66
![VS%20Code](https://img.shields.io/badge/VS%20Code-extension-0098FF?logo=visualstudiocode&logoColor=white)
77
![MCP](https://img.shields.io/badge/MCP-enabled-7C3AED)
88
![Node.js](https://img.shields.io/badge/Node.js-20%2B-339933?logo=nodedotjs&logoColor=white)
@@ -91,6 +91,7 @@ Tier ladder: $5/mo (sponsor badge + name in [`SPONSORS.md`](SPONSORS.md)) · $10
9191
- **CLI (`dg`)** — instance creation, attach/detach, start/stop, status, scan, enrich, schedule, export, fork, and migration
9292
- **VS Code extension** — chat, dashboard, Explorer (interactive 2D/3D graph + curated mutations), changed-files view, daemon connection, and local support tools
9393
- **Knowledge graph + cognitive engine** — features, workflows, data model, tensions, validated relationships, and dream-cycle reasoning
94+
- **Adaptive Future Engine** — advisory candidate-future ranking, future-fit scoring, compact objections, and bounded audit metadata for graph-tool and cognitive-workflow decisions
9495
- **Datastore-as-Hub** — first-class `datastore` entities, live schema introspection (`scan_database`), and the `schema_grounding` dream strategy for multi-repo SaaS projects sharing a backend (set `DATABASE_URL`; inert otherwise)
9596
- **Plugin host & SDK (v9.0.0 — stable seams M0–M6)** — in-process plugin runtime (`@dreamgraph/sdk` + `@dreamgraph/host`) with manifest discovery from `<instance>/plugins/<id>/plugin.json`, capability/effect gate registry, telemetry bridge, trust banner, and `dg plugin` CLI (`list`, `inspect`, `register`, `enable`, `disable`, `trust`, `reload`, `unload`). Hot reload/disable plus enriched `system://plugins` (activation, subscriptions, contributed tools/resources). Plugin-contributed MCP tools and resources via `ctx.tools.register` / `ctx.resources.register`, gated by `tools:register` / `resources:register` capabilities and naming/namespace prefix rules. M5 ships outbound webhooks as a *core* subsystem (`dg webhook` CLI; HMAC-signed delivery; persistent dead-letter; replay). M6 adds the UI/closure seams (archetypes, policies, markdown fences, UI hooks). Opt-in via `DG_ALLOW_INPROCESS_PLUGINS=true` plus per-plugin `trusted: true` in `instance.json`. See `examples/hello-events/` for a reference plugin and [`docs/sdk/`](docs/sdk/) for the developer guide and reference manual.
9697

@@ -304,6 +305,7 @@ DreamGraph has six major surfaces:
304305

305306
- **Knowledge graph** — features, workflows, data model, ADRs, UI registry, tensions, and validated edges
306307
- **Cognitive engine** — dream cycles, normalization, promotion, temporal/causal analysis, remediation planning
308+
- **Adaptive Future Engine** — ranks compliant candidate futures with graph evidence, ADR/workflow/API constraints, score factors, objections, and compact audit trails
307309
- **Daemon runtime** — the MCP-capable service layer exposed through stdio or HTTP
308310
- **CLI** — operational control over instances and daemon lifecycle
309311
- **VS Code extension** — the primary interactive editor experience for chat, dashboard, changed-files context, daemon connection, and local-tool execution
@@ -312,6 +314,7 @@ DreamGraph has six major surfaces:
312314
For deeper architectural detail, see:
313315
- [docs/architecture.md](docs/architecture.md)
314316
- [docs/cognitive-engine.md](docs/cognitive-engine.md)
317+
- [docs/adaptive-future-engine.md](docs/adaptive-future-engine.md)
315318
- [docs/tools-reference.md](docs/tools-reference.md)
316319
- [docs/workflows.md](docs/workflows.md)
317320

RELEASE_NOTES_v11.0.0.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# DreamGraph v11.0.0 — Adaptive Future Engine
2+
3+
Release date: 2026-05-26
4+
5+
v11.0.0 ships the Adaptive Future Engine release line. This release promotes candidate-future ranking, bounded future-fit scoring, and compact audit trails from the v11 plan into the released DreamGraph distribution.
6+
7+
## Headline Changes
8+
9+
### 1. Adaptive Future Engine
10+
11+
- Adds the shared Adaptive Future scaffold in `src/cognitive/adaptive-future-scaffold.ts`.
12+
- Classifies planning-doc, adapter, graph-tool, and cognitive-workflow task classes.
13+
- Records selected and rejected candidate IDs, score factors, evidence anchors, objections, route/fallback provenance, and validation failures as compact audit metadata.
14+
- Keeps all Adaptive Future output advisory and subordinate to accepted ADRs, workflows, API surface, data-model contracts, graph evidence, and explicit user intent.
15+
16+
### 2. Runtime Consumers
17+
18+
- `enrich_parser_nodes` now emits Adaptive Future audit metadata for graph-tool enrichment work.
19+
- `solidify_cognitive_insight` now carries Adaptive Future audit metadata through cognitive-workflow planning metadata.
20+
- Focused tests cover the scaffold, graph-tool audit consumer, and cognitive-workflow audit consumer.
21+
22+
### 3. Documentation And Release Alignment
23+
24+
- Adds dedicated Adaptive Future Engine documentation in `docs/adaptive-future-engine.md`.
25+
- Adds a user-guide page in `guide/14-adaptive-future-engine.md`.
26+
- Updates package versions, SDK docs, install guide references, VS Code extension metadata, root docs, and release notes to the v11.0.0 release line.
27+
28+
## Upgrade Notes
29+
30+
- No instance migration is required for v11.0.0.
31+
- Existing deterministic behavior remains available; Adaptive Future metadata is advisory context, not a hard enforcement mechanism.
32+
- Consumers that do not inspect `adaptive_future_audit` continue to behave as before.
33+
34+
## Artifacts
35+
36+
Expected release artifacts:
37+
38+
- `dreamgraph-11.0.0.tgz`
39+
- `dreamgraph-sdk-11.0.0.tgz`
40+
- `dreamgraph-host-11.0.0.tgz`
41+
- `dreamgraph-vscode-11.0.0.vsix`
42+
43+
## Verification
44+
45+
Release verification for this cut should include:
46+
47+
- focused Adaptive Future tests;
48+
- full `npm test` where practical;
49+
- `npm run build`;
50+
- package artifact creation with `npm pack` for root, SDK, and host packages;
51+
- VS Code extension packaging with `npm --prefix extensions/vscode run package`.

docs/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ This directory contains DreamGraph documentation, but the **canonical living doc
2020

2121
Some files in this directory are hand-written narrative or reference documents. They may provide additional background, but they are not the authoritative inventory of the current system state unless explicitly regenerated.
2222

23+
- [Adaptive Future Engine](adaptive-future-engine.md) — v11 advisory candidate-future ranking and audit-trail overview.
2324
- [Release Notes](release-notes.md) — manually curated implementation/release notes for notable features.
2425

2526
For the current graph-grounded documentation, start here:

docs/adaptive-future-engine.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Adaptive Future Engine
2+
3+
The Adaptive Future Engine is the v11 preference layer for DreamGraph. It ranks compliant candidate futures using graph evidence, accepted ADRs, workflow context, API/data-model contracts, and learned project preference signals.
4+
5+
It is advisory by design. ADRs, workflow contracts, API surface, and explicit user instructions remain the hard constraints. The engine helps choose among valid futures; it does not create a new enforcement path or a new cognitive lifecycle state.
6+
7+
## What It Adds
8+
9+
- **Candidate-future ranking** — compares plausible next actions instead of treating every valid change as equivalent.
10+
- **Future-fit scoring** — records compact score factors such as evidence coverage, workflow alignment, governance compatibility, blast radius, and reversibility.
11+
- **Future objections** — preserves why a candidate was rejected, including missing evidence, ADR conflicts, weak anchors, or uncertain fallback behavior.
12+
- **Adaptive audit trails** — stores selected and rejected candidate IDs, route/fallback provenance, score factors, evidence anchors, objections, and validation failures without persisting raw prompts or full model responses.
13+
- **Bounded task-class coverage** — classifies planning-doc, adapter, graph-tool, and cognitive-workflow changes for consistent audit metadata.
14+
15+
## Runtime Boundaries
16+
17+
Adaptive Future Engine output is subordinate to:
18+
19+
1. Accepted ADR guard rails.
20+
2. Registered workflows and lifecycle rules.
21+
3. API surface and data-model contracts.
22+
4. Knowledge-graph evidence and provenance.
23+
5. User intent for the current task.
24+
25+
If the engine has insufficient evidence, deterministic fallback behavior must remain available and visible in the audit trail.
26+
27+
## Where It Is Used
28+
29+
The v11 release wires the shared scaffold into graph-tool and cognitive-workflow consumers:
30+
31+
- `src/cognitive/adaptive-future-scaffold.ts` defines task classes, score factors, audit anchors, and deterministic audit helpers.
32+
- `src/tools/enrich-parser-nodes.ts` emits Adaptive Future audit metadata for graph-tool enrichment.
33+
- `src/tools/solidify-insight.ts` carries Adaptive Future audit metadata through cognitive insight solidification.
34+
35+
See also the user-facing guide page: [`guide/14-adaptive-future-engine.md`](../guide/14-adaptive-future-engine.md).

docs/architecture.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# DreamGraph Architecture
22

3-
Version: **10.6.0**
3+
Version: **11.0.0**
44
License: **DreamGraph Source-Available Community License v2.0**
55

66
## Overview
@@ -12,9 +12,24 @@ Core architectural surfaces:
1212
- **Daemon runtime** — serves MCP tools, dashboard routes, orchestration, and cognitive workflows
1313
- **Instance subsystem** — isolates projects and runtime state by UUID-scoped instance boundaries
1414
- **Knowledge graph** — captures system structure, behavior, decisions, and unresolved tensions
15+
- **Adaptive Future Engine** — ranks compliant candidate futures with evidence-bounded scoring and compact audit trails
1516
- **CLI (`dg`)** — lifecycle management, status, scanning, and operational commands
1617
- **VS Code extension** — dashboard embedding, chat UX, daemon/MCP client integration, changed-files UX
1718

19+
20+
## Adaptive Future Engine
21+
22+
The Adaptive Future Engine is the v11 advisory preference layer. It compares compliant candidate futures after higher-authority constraints have already been applied: accepted ADRs, workflow/lifecycle rules, API and data-model contracts, graph evidence, and current user intent.
23+
24+
Architecturally it provides:
25+
26+
- deterministic task-class inference for planning-doc, adapter, graph-tool, and cognitive-workflow changes;
27+
- future-fit score factors for evidence coverage, governance compatibility, workflow alignment, blast radius, reversibility, and fallback confidence;
28+
- compact objections for rejected candidates;
29+
- audit metadata that records selected/rejected candidate IDs, score factors, anchors, route/fallback provenance, and validation failures without storing raw prompts or full model responses.
30+
31+
The engine is not an enforcement subsystem and does not add a cognitive lifecycle state. Its output remains advisory and must degrade to deterministic fallback behavior when evidence is insufficient.
32+
1833
## Instance Model
1934

2035
Each DreamGraph instance has its own root directory under the master directory (typically `~/.dreamgraph/<uuid>/`). The instance stores:

docs/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@
1818
- [Data Model](data-model/_index.md)
1919
- [Workflows](workflows/_index.md)
2020
- [Architecture Decisions](architecture/_index.md)
21+
- [Adaptive Future Engine](adaptive-future-engine.md)
2122
- [UI Registry](ui-registry/_index.md)
2223
- [API Reference](api-reference/_index.md)
2324
- [Cognitive Status](cognitive-status.md)

docs/release-notes.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
# DreamGraph Release Notes
22

3+
## v11.0.0 - Adaptive Future Engine
4+
5+
DreamGraph v11.0.0 ships the Adaptive Future Engine release line: advisory candidate-future ranking, future-fit scoring, compact objections, route/fallback provenance, and bounded audit metadata for graph-tool and cognitive-workflow consumers.
6+
7+
See [`../RELEASE_NOTES_v11.0.0.md`](../RELEASE_NOTES_v11.0.0.md) for the full distribution notes.
8+
39
## Codex CLI native Architect adapter
410

511
The VS Code Architect now includes native `codex-cli` provider support following ADR-201's native CLI adapter constraints. The adapter keeps Codex-specific help probing, isolated `config.toml` generation, login-status validation, process execution, prompt serialization, and ProviderPort projection inside `extensions/vscode/src/architect-core/adapters/codex-cli/`.

docs/sdk/plugin-developer-guide/00-index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# DreamGraph Plugin Developer Guide
22

33
**Audience:** Engineers writing third-party plugins against `@dreamgraph/sdk`.
4-
**Engine baseline:** v10.6.0 "Renata" (M0–M6 implemented; M5 webhooks shipped; M4 schedule actions deferred).
4+
**Engine baseline:** v11.0.0 "Adaptive Future Engine" (M0–M6 implemented; M5 webhooks shipped; M4 schedule actions deferred; v11 Adaptive Future audit metadata available).
55
**Companion:** see the [Plugin Reference Manual](../plugin-reference/00-index.md) for strict, normative tables.
66

77
This guide is task-oriented. It walks you from "what is a plugin" through a working

docs/sdk/plugin-reference/00-index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# DreamGraph Plugin Reference Manual
22

33
**Audience:** Plugin authors and host implementors needing strict, normative tables.
4-
**Engine baseline:** v10.6.0 "Renata".
4+
**Engine baseline:** v11.0.0 "Adaptive Future Engine".
55
**Companion:** see the [Plugin Developer Guide](../plugin-developer-guide/00-index.md) for task-oriented walkthroughs.
66

77
This reference is the source of truth. Where the guide and the reference disagree,

explorer/package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)