Skip to content

Commit 6466121

Browse files
authored
docs: normalize remaining project naming in legacy docs
Normalize remaining human-facing project-name references in API and research docs. Scope: documentation-only; no runtime, fixture, validator, workflow, artifact, evidence-index, package, README, test, LLM, embedding, fuzzy, or taxonomy changes.
1 parent 50ec1a4 commit 6466121

2 files changed

Lines changed: 25 additions & 25 deletions

File tree

docs/API_SURFACE.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Purpose
44

5-
This document describes the stable Comptextv7 API, dashboard, export, and report
5+
This document describes the stable CompText V7 API, dashboard, export, and report
66
surfaces that future benchmark/regression summaries can reference. It also
77
records integration expectations for sanitized outputs from
88
`ProfRandom92/Comptext-Daimler-Experiment-` without introducing runtime coupling.
@@ -32,7 +32,7 @@ available. This guardrail is intentionally lightweight: it validates helper
3232
scripts, available local checks, and contract examples while
3333
benchmark/regression evidence remains a sanitized report handoff from
3434
`ProfRandom92/Comptext-Daimler-Experiment-`, not a runtime dependency of
35-
Comptextv7.
35+
CompText V7.
3636

3737
Branch discipline remains part of the API contract process: create a feature
3838
branch from `main` when available, open a PR, request review, and never push
@@ -77,7 +77,7 @@ summaries include:
7777
## Export/report endpoints
7878

7979
`/export.json` and `/export.csv` are the primary report handoff endpoints inside
80-
Comptextv7. They should remain deterministic enough for review, small enough for
80+
CompText V7. They should remain deterministic enough for review, small enough for
8181
PR artifacts, and explicit about any schema changes.
8282

8383
`docs/reports/dashboard-health-summary.json` is the dashboard-facing static
@@ -94,14 +94,14 @@ Future report endpoints such as `/reports/benchmark-summary`,
9494
`/reports/regression-summary`, or `/reports/sanitization-summary` should not be
9595
added until a schema, security review, and issue scope approve them. If added,
9696
they should consume sanitized summaries only and should not execute experiment
97-
repository workloads from the Comptextv7 runtime.
97+
repository workloads from the CompText V7 runtime.
9898

9999
## Payload and report contract expectations
100100

101101
Accepted report summaries should be:
102102

103103
- Synthetic in documentation examples.
104-
- Sanitized before being copied into Comptextv7.
104+
- Sanitized before being copied into CompText V7.
105105
- Small enough to review in a pull request.
106106
- Text-based: Markdown, JSON, or CSV.
107107
- Explicit about `source_repo`, `target_repo`, `report_type`, status, timestamp
@@ -115,7 +115,7 @@ Machine-readable contract schemas now live under `contracts/` and are written as
115115
lightweight JSON Schema-like documents that future agents and CI can inspect
116116
without adding runtime dependencies:
117117

118-
- `contracts/api-dashboard.schema.json` describes Comptextv7 API routes,
118+
- `contracts/api-dashboard.schema.json` describes CompText V7 API routes,
119119
dashboard views, export formats, sanitized report integration points, and
120120
security notes.
121121
- `contracts/benchmark-summary.schema.json` describes synthetic benchmark
@@ -183,9 +183,9 @@ of reimplementing release-readiness logic.
183183

184184
## Compatibility with benchmark/regression reports
185185

186-
Benchmark summaries should map to Comptextv7 review surfaces this way:
186+
Benchmark summaries should map to CompText V7 review surfaces this way:
187187

188-
| Report type | Expected Comptextv7 use |
188+
| Report type | Expected CompText V7 use |
189189
| --- | --- |
190190
| `benchmark_summary` | Compare p50/p95/p99, RPS, error rate, and payload size for dashboard/API routes. |
191191
| `regression_summary` | Decide whether a PR should merge, require remediation, or split into smaller changes. |
@@ -198,14 +198,14 @@ or high/critical forensic findings.
198198

199199
## Dashboard/API boundaries
200200

201-
Comptextv7 may:
201+
CompText V7 may:
202202

203203
- Display sanitized benchmark/regression status.
204204
- Export local dashboard evidence as JSON or CSV.
205205
- Document future report contracts.
206206
- Add small schema-version fields in future PRs.
207207

208-
Comptextv7 should not yet:
208+
CompText V7 should not yet:
209209

210210
- Import code from `ProfRandom92/Comptext-Daimler-Experiment-`.
211211
- Run experiment repository workloads as part of normal dashboard/API startup.

docs/research_positioning.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
CompText V7 is the deterministic replay-integrity layer for compressed operational agent traces. It asks whether compact or reconstructed operational state can preserve the evidence, constraints, blockers, dependencies, recovery paths, capability boundaries, and tool-order signals needed to replay a safe operational trajectory after compression. The project is complementary to learned context-compression research, RAG evaluation, vector-memory systems, serving-layer cache optimization, and durable workflow infrastructure, but it does not replace those systems or claim solved AI memory.
44

5-
## What CompTextv7 measures
5+
## What CompText V7 measures
66

7-
CompTextv7 measures fixture-bound replay survivability with deterministic artifacts. Current metrics and labels are intended to show whether explicitly encoded operational fields survive replay pressure, not whether a model answer is useful or semantically complete.
7+
CompText V7 measures fixture-bound replay survivability with deterministic artifacts. Current metrics and labels are intended to show whether explicitly encoded operational fields survive replay pressure, not whether a model answer is useful or semantically complete.
88

99
Measured signals include:
1010

@@ -20,15 +20,15 @@ Measured signals include:
2020

2121
## Replay-survivability evaluator brief
2222

23-
CompTextv7 evaluates replay survivability of compact operational state: whether fixture-authored operational fields can be compacted, reconstructed, replayed, and audited without relying on an LLM judge. The current prototype measures field survival, evidence survival, operational drift, and deterministic failure labels against checked-in fixtures. Its claims are therefore fixture-bound and prototype-scoped: it can show what the current validators detect under replay/compression pressure, not whether a deployed agent or memory product will succeed in the wild.
23+
CompText V7 evaluates replay survivability of compact operational state: whether fixture-authored operational fields can be compacted, reconstructed, replayed, and audited without relying on an LLM judge. The current prototype measures field survival, evidence survival, operational drift, and deterministic failure labels against checked-in fixtures. Its claims are therefore fixture-bound and prototype-scoped: it can show what the current validators detect under replay/compression pressure, not whether a deployed agent or memory product will succeed in the wild.
2424

25-
Adjacent benchmark ecosystems include long-term memory benchmarks, RAG evaluation, long-horizon agent evaluation, software-agent/task benchmarks, and context-compression evaluation. Those ecosystems often evaluate task success, retrieval, answer quality, memory recall, or downstream performance. CompTextv7 is complementary: it evaluates whether compact operational state remains replayable and auditable, and it identifies which blockers, constraints, evidence, dependencies, recovery paths, or tool-order signals fail under compression/replay pressure.
25+
Adjacent benchmark ecosystems include long-term memory benchmarks, RAG evaluation, long-horizon agent evaluation, software-agent/task benchmarks, and context-compression evaluation. Those ecosystems often evaluate task success, retrieval, answer quality, memory recall, or downstream performance. CompText V7 is complementary: it evaluates whether compact operational state remains replayable and auditable, and it identifies which blockers, constraints, evidence, dependencies, recovery paths, or tool-order signals fail under compression/replay pressure.
2626

27-
Why this matters: fluent summaries can lose blockers, constraints, evidence, dependencies, or recovery paths while still reading well. CompTextv7 treats that as deterministic replay degradation, not subjective text quality. The review path is the current trust chain: fixtures, generators, committed artifacts, Markdown summaries, README/doc values, artifact drift validation, and CI checks. See [Iterative Replay Degradation](iterative_replay_degradation.md), [Benchmark Explanation](BENCHMARK_EXPLANATION.md), the committed [iterative replay degradation summary](../artifacts/iterative_replay_degradation_results.summary.md), and [`scripts/validate_replay_artifact_drift.py`](../scripts/validate_replay_artifact_drift.py).
27+
Why this matters: fluent summaries can lose blockers, constraints, evidence, dependencies, or recovery paths while still reading well. CompText V7 treats that as deterministic replay degradation, not subjective text quality. The review path is the current trust chain: fixtures, generators, committed artifacts, Markdown summaries, README/doc values, artifact drift validation, and CI checks. See [Iterative Replay Degradation](iterative_replay_degradation.md), [Benchmark Explanation](BENCHMARK_EXPLANATION.md), the committed [iterative replay degradation summary](../artifacts/iterative_replay_degradation_results.summary.md), and [`scripts/validate_replay_artifact_drift.py`](../scripts/validate_replay_artifact_drift.py).
2828

29-
## What CompTextv7 does not measure
29+
## What CompText V7 does not measure
3030

31-
CompTextv7 does not measure general intelligence, answer quality, production readiness, or universal memory. It intentionally avoids:
31+
CompText V7 does not measure general intelligence, answer quality, production readiness, or universal memory. It intentionally avoids:
3232

3333
- LLM judges or subjective scoring;
3434
- embeddings, vector databases, graph stores, and external APIs;
@@ -50,23 +50,23 @@ The core contribution is a small deterministic review layer for operational repl
5050

5151
## Operational state vs raw chat history
5252

53-
CompTextv7 focuses on operational state, not raw chat-history retention. Rather than preserving every dialogue turn, it extracts, compacts, reconstructs, and verifies the fields that fixtures declare operationally relevant: tasks, constraints, blockers, evidence, dependencies, tool order, recovery actions, and continuation requirements.
53+
CompText V7 focuses on operational state, not raw chat-history retention. Rather than preserving every dialogue turn, it extracts, compacts, reconstructs, and verifies the fields that fixtures declare operationally relevant: tasks, constraints, blockers, evidence, dependencies, tool order, recovery actions, and continuation requirements.
5454

5555
This framing is intentionally narrower than semantic memory. A replay can pass only for the fields represented in the fixture and checked by the deterministic validator.
5656

5757
## How deterministic replay validation differs from adjacent categories
5858

59-
| Category | What that category usually evaluates or provides | CompTextv7 boundary |
59+
| Category | What that category usually evaluates or provides | CompText V7 boundary |
6060
| --- | --- | --- |
61-
| RAG evaluation | Retrieval quality, answer grounding, citation coverage, or generated-answer quality. | CompTextv7 does not retrieve documents or judge generated answers. It checks whether fixture-defined operational state survives compact/replay cycles. |
62-
| Vector memory | Embedding-based recall and similarity search over stored memories. | CompTextv7 does not use embeddings or vector databases. It compares explicit fixture IDs, fields, attachments, and normalized values. |
63-
| KV-cache compression | Serving-layer efficiency for model attention/cache reuse. | CompTextv7 does not optimize model internals or inference caches. It emits reviewable replay artifacts and field-survival metrics. |
64-
| Workflow orchestration | Durable execution, retries, scheduling, state machines, and tool execution. | CompTextv7 does not run autonomous workflows. It validates whether replayed operational state still contains fixture-defined continuation requirements. |
65-
| Learned context compression | Model-learned summaries or compressed prompts optimized for downstream performance. | CompTextv7 does not train or evaluate a learned compressor. It measures deterministic replay preservation under controlled fixtures. |
61+
| RAG evaluation | Retrieval quality, answer grounding, citation coverage, or generated-answer quality. | CompText V7 does not retrieve documents or judge generated answers. It checks whether fixture-defined operational state survives compact/replay cycles. |
62+
| Vector memory | Embedding-based recall and similarity search over stored memories. | CompText V7 does not use embeddings or vector databases. It compares explicit fixture IDs, fields, attachments, and normalized values. |
63+
| KV-cache compression | Serving-layer efficiency for model attention/cache reuse. | CompText V7 does not optimize model internals or inference caches. It emits reviewable replay artifacts and field-survival metrics. |
64+
| Workflow orchestration | Durable execution, retries, scheduling, state machines, and tool execution. | CompText V7 does not run autonomous workflows. It validates whether replayed operational state still contains fixture-defined continuation requirements. |
65+
| Learned context compression | Model-learned summaries or compressed prompts optimized for downstream performance. | CompText V7 does not train or evaluate a learned compressor. It measures deterministic replay preservation under controlled fixtures. |
6666

6767
## Artifact-backed JSON and CI checks
6868

69-
CompTextv7 uses artifact-backed JSON and deterministic Markdown summaries so reviewers can inspect the exact replay evidence for a commit. CI artifacts are evidence records for tested fixtures; they are not universal guarantees.
69+
CompText V7 uses artifact-backed JSON and deterministic Markdown summaries so reviewers can inspect the exact replay evidence for a commit. CI artifacts are evidence records for tested fixtures; they are not universal guarantees.
7070

7171
## Fixture-bound baseline interpretation
7272

0 commit comments

Comments
 (0)