docs: improve thesis pdf code wrapping
This commit is contained in:
@@ -43,11 +43,18 @@ header-includes:
|
|||||||
</style>
|
</style>
|
||||||
- \usepackage{graphicx}
|
- \usepackage{graphicx}
|
||||||
- \usepackage{booktabs}
|
- \usepackage{booktabs}
|
||||||
|
- \usepackage{tabulary}
|
||||||
- \usepackage{hyperref}
|
- \usepackage{hyperref}
|
||||||
- \usepackage{hyperxmp}
|
- \usepackage{hyperxmp}
|
||||||
- \usepackage[dvipsnames]{xcolor}
|
- \usepackage[dvipsnames]{xcolor}
|
||||||
- \usepackage{fancyhdr}
|
- \usepackage{fancyhdr}
|
||||||
- \pagestyle{fancy}
|
- \pagestyle{fancy}
|
||||||
|
- \usepackage{seqsplit}
|
||||||
|
# Pandoc emits inline code as \texttt{...}. This blunt wrapper keeps long
|
||||||
|
# paths and commands from overflowing PDF table cells.
|
||||||
|
- |
|
||||||
|
\let\origtexttt\texttt
|
||||||
|
\renewcommand{\texttt}[1]{{\origtexttt{\seqsplit{#1}}}}
|
||||||
- \usepackage{fvextra}
|
- \usepackage{fvextra}
|
||||||
- \fvset{breaklines=true, breaknonspaceingroup=true, breakanywhere=true}
|
- \fvset{breaklines=true, breaknonspaceingroup=true, breakanywhere=true}
|
||||||
- \fancyhead[L]{\small lda.chat}
|
- \fancyhead[L]{\small lda.chat}
|
||||||
@@ -591,7 +598,7 @@ provider-specific knowledge.
|
|||||||
The implementation is organized into focused packages with clear boundaries:
|
The implementation is organized into focused packages with clear boundaries:
|
||||||
|
|
||||||
| Package | Responsibility |
|
| Package | Responsibility |
|
||||||
| --- | --- |
|
| --- | --------- |
|
||||||
| `wf_core` | Deterministic workflow kernel: graph execution, state, outcomes, trace, resume |
|
| `wf_core` | Deterministic workflow kernel: graph execution, state, outcomes, trace, resume |
|
||||||
| `wf_authoring` | Authoring primitives: `NodeSpec`, `WorkflowBuilder`, DSL, reducer authoring, recipes |
|
| `wf_authoring` | Authoring primitives: `NodeSpec`, `WorkflowBuilder`, DSL, reducer authoring, recipes |
|
||||||
| `wf_platform` | Neutral source DTOs, source visibility, permission metadata, and policy |
|
| `wf_platform` | Neutral source DTOs, source visibility, permission metadata, and policy |
|
||||||
@@ -905,47 +912,92 @@ under the `local.report` namespace.
|
|||||||
The case study exercises the full lifecycle through CLI commands. The commands
|
The case study exercises the full lifecycle through CLI commands. The commands
|
||||||
demonstrate the agent-operable surface:
|
demonstrate the agent-operable surface:
|
||||||
|
|
||||||
1. **Config validation.** `wf config validate` checks that the config file is
|
1. **Config validation.** The config file is checked before server startup:
|
||||||
well-formed and that the Python source module can be imported.
|
|
||||||
|
|
||||||
2. **Server startup.** `wf-rpc-server --config wf.config.json` starts the
|
```powershell
|
||||||
workflow server with the configured store, transport, and source providers.
|
wf config validate
|
||||||
|
```
|
||||||
|
|
||||||
3. **Status check.** `wf status` confirms the server is reachable.
|
This verifies that the file is well-formed and that the Python source module
|
||||||
|
can be imported.
|
||||||
|
|
||||||
4. **Capability discovery.** `wf cap list --source local.report` lists the
|
2. **Server startup.** The configured workflow server starts with its store,
|
||||||
three capabilities exposed by the Python source.
|
transport, and source providers:
|
||||||
|
|
||||||
5. **Capability call.** `wf cap call local.report.extract_report --input-file
|
```powershell
|
||||||
cap-input.json --format compact` invokes the extraction capability and
|
wf-rpc-server --config wf.config.json
|
||||||
returns structured JSON.
|
```
|
||||||
|
|
||||||
6. **Draft creation.** `wf draft create-from-capability report_ws
|
3. **Status check.** The status command confirms the server is reachable:
|
||||||
local.report.extract_report` seeds a draft workspace from the capability's
|
|
||||||
input/output schemas.
|
|
||||||
|
|
||||||
7. **Draft validation.** `wf draft validate report_ws` checks schema
|
```powershell
|
||||||
conformance and source availability.
|
wf status
|
||||||
|
```
|
||||||
|
|
||||||
8. **Artifact saving.** `wf draft save report_ws --artifact report_case_study
|
4. **Capability discovery.** The report source exposes three capabilities:
|
||||||
--version 1 --title "Report Case Study" --binding local.report=local.report`
|
|
||||||
saves an immutable artifact with source bindings.
|
|
||||||
|
|
||||||
9. **Deployment saving.** `wf deploy save report_case_study.default --artifact
|
```powershell
|
||||||
report_case_study --version 1 --binding local.report=local.report` creates
|
wf cap list --source local.report
|
||||||
a deployment binding.
|
```
|
||||||
|
|
||||||
10. **Deployment validation.** `wf deploy validate report_case_study.default`
|
5. **Capability call.** The extraction capability returns structured JSON:
|
||||||
verifies that bound sources are available and compatible.
|
|
||||||
|
|
||||||
11. **Run execution.** `wf run start report_case_study.default --input-file
|
```powershell
|
||||||
run-input.json --trace-from 0 --trace-limit 5` starts a workflow run.
|
wf cap call local.report.extract_report --input-file cap-input.json --format compact
|
||||||
|
```
|
||||||
|
|
||||||
12. **Run inspection.** `wf run inspect <run_id>` shows the run status, output,
|
6. **Draft creation.** A draft workspace is seeded from the capability's
|
||||||
and diagnostics.
|
input/output schemas:
|
||||||
|
|
||||||
13. **Run trace.** `wf run trace <run_id> --from 0 --limit 5` shows the trace
|
```powershell
|
||||||
frames recorded during execution.
|
wf draft create-from-capability report_ws local.report.extract_report
|
||||||
|
```
|
||||||
|
|
||||||
|
7. **Draft validation.** The draft is checked for schema conformance and source
|
||||||
|
availability:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf draft validate report_ws
|
||||||
|
```
|
||||||
|
|
||||||
|
8. **Artifact saving.** The draft becomes an immutable artifact with source
|
||||||
|
bindings:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf draft save report_ws --artifact report_case_study --version 1 --title "Report Case Study" --binding local.report=local.report
|
||||||
|
```
|
||||||
|
|
||||||
|
9. **Deployment saving.** The artifact is bound into a runnable deployment:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf deploy save report_case_study.default --artifact report_case_study --version 1 --binding local.report=local.report
|
||||||
|
```
|
||||||
|
|
||||||
|
10. **Deployment validation.** The deployment is checked for bound source
|
||||||
|
availability and compatibility:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf deploy validate report_case_study.default
|
||||||
|
```
|
||||||
|
|
||||||
|
11. **Run execution.** A workflow run starts from the deployment:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf run start report_case_study.default --input-file run-input.json --trace-from 0 --trace-limit 5
|
||||||
|
```
|
||||||
|
|
||||||
|
12. **Run inspection.** The run status, output, and diagnostics can be
|
||||||
|
inspected:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf run inspect <run_id>
|
||||||
|
```
|
||||||
|
|
||||||
|
13. **Run trace.** Trace frames recorded during execution can be listed:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
wf run trace <run_id> --from 0 --limit 5
|
||||||
|
```
|
||||||
|
|
||||||
(Evidence: `examples/report_workflow/README.md`, `tests/examples/test_report_workflow_example.py`.)
|
(Evidence: `examples/report_workflow/README.md`, `tests/examples/test_report_workflow_example.py`.)
|
||||||
|
|
||||||
@@ -1050,14 +1102,19 @@ claims auditable from the text. A final submission should regenerate this table
|
|||||||
from the exact submitted commit.
|
from the exact submitted commit.
|
||||||
|
|
||||||
| Field | Value |
|
| Field | Value |
|
||||||
| --- | --- |
|
| --- | --------- |
|
||||||
| Date run | 2026-06-16 |
|
| Date run | 2026-06-16 |
|
||||||
| Baseline commit | `e24f2892` before subsequent document-polish edits |
|
| Baseline commit | `e24f2892` before subsequent document-polish edits |
|
||||||
| Command | `uv run pytest tests/docs tests/examples/test_report_workflow_example.py tests/examples/test_browser_click_workflow_example.py tests/examples/test_opencode_browser_click_challenge.py tests/artifacts/test_validation.py tests/wf_api/test_run_api.py -q` |
|
|
||||||
| Result | `72 passed in 9.22s` |
|
| Result | `72 passed in 9.22s` |
|
||||||
| Environment | Local Windows development environment, Python via `uv` |
|
| Environment | Local Windows development environment, Python via `uv` |
|
||||||
| Scope | Documentation links, report workflow, browser-click workflow, challenge harness, deployment validation, and run API tests |
|
| Scope | Documentation links, report workflow, browser-click workflow, challenge harness, deployment validation, and run API tests |
|
||||||
|
|
||||||
|
Command:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
uv run pytest tests/docs tests/examples/test_report_workflow_example.py tests/examples/test_browser_click_workflow_example.py tests/examples/test_opencode_browser_click_challenge.py tests/artifacts/test_validation.py tests/wf_api/test_run_api.py -q
|
||||||
|
```
|
||||||
|
|
||||||
## Implemented Scope Matrix
|
## Implemented Scope Matrix
|
||||||
|
|
||||||
| Area | Implemented evidence | Not claimed | Future work |
|
| Area | Implemented evidence | Not claimed | Future work |
|
||||||
|
|||||||
Reference in New Issue
Block a user