You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 4eab9e4
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: CHANGELOG.md
+26Lines changed: 26 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,31 @@
1
1
# Changelog
2
2
3
+
## 2.1.1 — 2026-09-09 — Lightweight quality and delivery fixes
4
+
5
+
- Summarize missing/failed pages, body text, OCR/visual risks and unsupported controls; expose
6
+
paid cloud recommendations independently of local/auto/cloud execution policy.
7
+
- Preserve best-effort Markdown and optional strict gating; provide the same assessment in
8
+
read, parse and convert, including cached artifacts. Local OCR remains unsupported.
9
+
- Fix command ampersands and code fencing, report control replacement without changing IR,
10
+
respect disabled DOCX strike styles, and report actual output bytes on cache hits.
11
+
- Share immutable identical assets across candidates and selected artifacts, using atomic
12
+
replacement and copy fallback. Invalidate affected DOCX parser and Markdown renderer caches.
13
+
- Update the bundled Agent skill to consume quality reports and keep upload choices explicit.
14
+
- Depend on the published DeckProbe 2.6.0 package; remove the temporary vendor archive and bundled dependency override.
15
+
16
+
- Ship a DeckOps Agent Skill with format, artifact, output, recipe, and limit references for traceable document-to-knowledge workflows.
17
+
- Add `deckops install --skills` with project/global/explicit targets, dry-run JSON receipts, managed-file hash protection, and preservation of local additions.
18
+
- Validate skill resources during checks and prepack, and verify installation from the production npm tarball.
19
+
20
+
## 2.1.0 — 2026-09-09
21
+
22
+
- Default bare CLI calls now return Markdown; add `read()` SDK, `--format ir`, JSON content envelopes and independent run reports.
23
+
- Introduce evidence-based assessments, a shared capability registry, policy provenance, negative overrides, candidate comparison and a final quality gate.
24
+
- Detect sparse raster PDF pages individually; unknown/unverified remedies and visual-only warnings do not automatically upload.
25
+
- Preserve local/cloud candidates, freeze local source bytes, propagate cancellation, journal uncertain submissions and disable mutation retries.
26
+
- Integrate DeckProbe 2.6.0 bounded preflight and exact SmartArt inventory; bundle the tested upstream release snapshot for independent installs.
27
+
- Keep stdout ownership in the CLI and preserve cache/export image lifetimes.
28
+
3
29
## @deckflow/deckops 2.0.0 — 2026-09-07
4
30
5
31
- License DeckOps-owned code under AGPL-3.0-only from this license-change commit onward. Preserve third-party licenses and notices; already published releases through 1.1.1 remain under their original MIT license.
Copy file name to clipboardExpand all lines: README.md
+93-5Lines changed: 93 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,10 +2,13 @@
2
2
3
3
> Parse any document into an agent-operable representation.
4
4
5
-
DeckOps turns documents into**durable IR artifacts** and derives views from them. Parse once — then convert, again and again, without ever re-reading the source.
5
+
DeckOps reads documents as**Markdown by default**, with quality evidence and policy-controlled upgrades. Explicit `parse` creates durable IR artifacts for repeated use.
@@ -26,18 +29,76 @@ The CLI and Node.js entry require Node.js 22.18 or newer. Frontend applications
26
29
27
30
Local PDF parsing uses `pdf-lite-parse@0.2.1` and exports embedded images without expensive composite-figure rasterization. Extractable overlay text is retained separately; visual fidelity losses are reported in `quality`. `--no-images` (SDK: `includeImages: false`) skips image export entirely.
28
31
29
-
Ordinary `npm install @deckflow/deckops` is now lightweight for PDF parsing: the parser embeds a pinned subset of PDF.js and its portable resources, with no separately installed `pdfjs-dist` or automatic canvas dependency. DeckProbe's independent optional platform CLI packages are unchanged. To omit those as well and use the strict no-native installation:
32
+
Ordinary `npm install @deckflow/deckops` is now lightweight for PDF parsing: the parser embeds a pinned subset of PDF.js and its portable resources, with no separately installed `pdfjs-dist` or automatic canvas dependency. DeckProbe is pinned to the published 2.6.0 package; it uses its matching optional native CLI when available and falls back to WASM otherwise. To omit those as well and use the strict no-native installation:
30
33
31
34
```bash
32
35
npm install --omit=optional @deckflow/deckops
33
36
```
34
37
35
38
Embedded-image PDF parsing works in both installation modes without canvas. Use the cloud engine explicitly when full figure fidelity is needed. Applications calling `pdf-lite-parse` directly can explicitly install canvas for its opt-in composite mode; DeckOps does not enable it automatically.
SDK options do not inherit CLI product configuration. `cloudLimits` can bound source bytes/pages;
69
+
unverifiable page limits or monetary `maxCost` prevent submission. A timeout/unknown preflight
70
+
is never upload authorization. OCR/SmartArt/table repair capabilities are currently marked
71
+
unverified and do not automatically trigger paid attempts. Known alternate document parsing and
72
+
cloud-only formats use the declared API contract, followed by conservative candidate comparison.
73
+
Cloud failures retain a usable local candidate; an unresolved submission journal prevents automatic
74
+
resubmission. Existing artifact reads never upload the source. Source facts, heuristic quality
75
+
issues and unassessed dimensions remain distinct; no accuracy score is invented.
76
+
77
+
## Use from a coding agent
78
+
79
+
DeckOps ships an Agent Skill that teaches coding agents when to parse a source, when to reuse an artifact, how to preserve provenance, and how to report quality limits. Install it at project scope with:
80
+
81
+
```bash
82
+
deckops install --skills
83
+
```
84
+
85
+
Auto mode installs into agent directories already present in the project and falls back to `.agents/skills/deckops/`. Select a host or inspect the plan explicitly when needed:
The package and installer use the same files from [`skills/deckops/`](skills/deckops/). Upgrades protect managed files that were edited after installation and preserve other local files in the skill directory; `--force` explicitly replaces conflicting managed content. Installing the skill does not change DeckOps credentials, engine defaults, or document data.
95
+
37
96
## Two verbs, deliberately
38
97
39
98
```
40
-
parse document → IR artifact the only parsing action; produces IR, never markdown
99
+
SOURCE document → Markdown default content entry
100
+
parse document → IR artifact persistent IR workflow
convert IR artifact → view --to markdown (v1); never re-parses the source
42
103
```
43
104
@@ -55,7 +116,7 @@ doc/
55
116
-**Local and private by default.**`--engine local` is the default, requires no login, and never constructs a cloud client. URL source mode only fetches the URL the user supplied and bounded redirects.
56
117
-**Parse twice, pay once.** Same bytes + engine + compatible parser version + options = instant artifact reuse. Compatibility uses the parser major, plus the minor for pre-1.0 PDF releases. `--json` reports `"engine": "artifact-cache"`.
57
118
-**Convert never re-parses.** Manifest v2 stores public `deckir.v1`; local artifacts remain convertible indefinitely. The 7-day lifetime only applies to an optional cloud `irKey`.
58
-
-**No silent fallback.**`--engine auto`stays local unless `--allow-upload`is explicitly present. `--fail-on-degraded`turns a quality warning into a failure.
119
+
-**No silent fallback.**`--engine auto`upgrades only with upload authorization and a matching supported remedy. Authorization may come from flags, environment or user config; `--no-allow-upload`overrides it. `--fail-on-degraded`rejects the final result after candidate selection and output checks.
59
120
60
121
Local parsers enforce source, ZIP expansion/ratio, asset, XML depth/event, URL response, timeout and worker-heap limits. The main budgets can be raised explicitly with `--max-source-bytes`, `--max-expanded-bytes`, `--max-part-bytes`, `--max-asset-bytes`, `--max-total-asset-bytes`, `--max-zip-entries`, `--max-url-bytes` and `--worker-heap-mb`; overrides are recorded in the artifact cache identity.
61
122
@@ -268,3 +329,30 @@ Source and build instructions are available in this repository; use the tag or
268
329
commit corresponding to the version you distribute. When distributing or
269
330
operating a modified network-accessible version, follow the applicable
270
331
corresponding-source requirements in AGPL-3.0, including section 13.
332
+
333
+
## Lightweight quality and paid cloud parsing
334
+
335
+
Local parsing extracts available content quickly. It does not run OCR or reconstruct
336
+
complex visual semantics. Default Markdown remains best-effort: quality limitations are
337
+
reported on stderr without turning them into execution failures. Agent integrations should
338
+
use `deckops SOURCE --json` (content plus report) or retain `--report RUN.json` and stderr.
339
+
340
+
`report.assessment.summary` includes known source/parsed pages, missing and failed pages,
341
+
searchable body text, suspected OCR pages, visual-risk pages and control-character counts.
342
+
Unknown source counts remain absent. Missing-page lists are capped at 1,000; the full count
343
+
and truncation flag remain available. `no_issue_detected` does not certify completeness.
344
+
345
+
`assessment.recommendation` may suggest paid cloud high-quality parsing even in local mode;
346
+
`decision` independently records whether policy permits execution. Local never uploads.
347
+
Automatic cloud submission still requires upload authorization, compatible parameters,
348
+
verified capabilities and configured limits. OCR, layout and other specialized remedies
349
+
without a verified service contract remain in the capability catalog as unverified;
350
+
a user may explicitly select cloud parsing without a promise that it repairs every defect.
351
+
Cloud output retains its own quality assessment. `--fail-on-degraded` remains opt-in.
352
+
353
+
Markdown preserves ordinary `&&` and literal code contents, and replaces unsupported C0/DEL
354
+
controls with U+FFFD plus diagnostics; original IR is retained. Output byte counts describe
355
+
actual files, including cache hits. Identical assets within an artifact's candidates and
356
+
selected result share immutable files through hard links where supported, with normal-file
357
+
fallback. Updates replace files atomically; do not edit artifact assets in place. Portable
358
+
exports remain independent copies. Global deduplication and old export cleanup are deferred.
Copy file name to clipboardExpand all lines: package.json
+13-10Lines changed: 13 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
{
2
2
"name": "@deckflow/deckops",
3
-
"version": "2.0.0",
3
+
"version": "2.1.1",
4
4
"description": "Parse any document into an agent-operable representation. Parse once, convert repeatedly: PDF, PPTX, DOCX, Keynote and URLs into durable IR artifacts and Markdown.",
0 commit comments