Repository navigation
hub: add lokdocsqr corpus (local-first file automation) - #2908
Conversation
|
Thanks for this contribution — we'd like to merge it. Before we can, we need a signed Contributor License Agreement from: @badretd It is a one-time thing per contributor, not per pull request. Read CLA.md, then open a small pull request adding your GitHub username to Once it is merged, comment |
|
@cla-bot check |
|
Thanks for this contribution — we'd like to merge it. Before we can, we need a signed Contributor License Agreement from: @badretd It is a one-time thing per contributor, not per pull request. Read CLA.md, then open a small pull request adding your GitHub username to Once it is merged, comment |
|
Re-checking the CLA status for every commit author on this pull request… |
|
@cla-bot check |
|
Thanks for this contribution — we'd like to merge it. Before we can, we need a signed Contributor License Agreement from: @badretd It is a one-time thing per contributor, not per pull request. Read CLA.md, then open a small pull request adding your GitHub username to Once it is merged, comment |
|
Re-checking the CLA status for every commit author on this pull request… |
|
@cla-bot check |
|
Re-checking the CLA status for every commit author on this pull request… |
|
Xerj Merger made the fix: added the |
What this changes, and why
Adds the
lokdocsqrreference corpus:tools/xerj-code/hub/lokdocsqr.jsonplus itsliverow intools/xerj-code/hub/backlog/backlog-100.json. The corpus is the LokDocSQR repository pinned at the latest commit onmain.What the corpus is FOR: an agent building or maintaining a local-first file-automation engine queries this for workflow-graph execution, scope-enforced filesystem mutations, dry-run and approval policy, append-only audit and rollback, the
.ldsqDSL grammar and compiler, and the CLI contracts.Pin
e17f591b71d02f51b0fe4f454e77fbfed0fbf4e6— the latest commit onmain(2026-11-03), not the0.1.0pre-release tag (3cd4dd7).Licence review (G4)
Opened
LICENSEat the pin: verbatim Apache License 2.0.pyproject.tomldeclaresApache-2.0andNOTICEcarries the copyright.licenses/gpl-3.0.txtandlicenses/lgpl-3.0.txtare the licence texts for the optional PySide6 GUI extra, not bundled CLI source;NOTICEstates the CLI does not include PySide6.THIRD-PARTY-NOTICESis a dependency inventory, not this project's licence. No vendored third-party source in the tree. Review block:spdx: Apache-2.0,use: adapt-with-attribution.Why this is not memorised (G3)
LokDocSQR is a pre-1.0, domain-specific project. The corpus is the implementation and design record for its scope-enforced filesystem layer, executor, audit/rollback and DSL — not a famous public snippet.
Checks
python3 tools/xerj-code/hub/validate_hub.py→corpus-hub validation OK: 561 manifests, 3 recipes, backlog 597 rows (559 live)xerj corpus add --from tools/xerj-code/hub/lokdocsqr.json --as lokdocsqr-hubtest→ rebuilt ate17f591b71d0,licence=Apache-2.0, review block preserved.xerj corpus index lokdocsqr→corpus 'lokdocsqr' searchable: 4266 records(217 code files; 2 junk skips: an empty__init__.pyand a 0-page sample PDF).src/lokdocsqr/core/scope.pyREADME.md/ policy docsREADME.mdaudit/rollbackdocs/DSL.mdsrc/lokdocsqr/cli/main.pyChecklist from CONTRIBUTING §5: filename equals the
corpusfield; full 40-hex SHA; the source has a humanreviewblock; backlog row islive/ lane A; no binaries.Provenance
--fromrebuild, the index run, and the fivexerj codequeries above.cargo test -p xerj-common xccode::manifestgate was not run locally;validate_hub.pyand the--fromrebuild cover the same manifest shape. The corpus is first-party; if the repository's licence changes at a future pin, this review must be redone.