Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions .github/workflows/publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ jobs:
name: verify committed release documentation
if: github.ref == 'refs/heads/main' || inputs.mode == 'qualify'
runs-on: ubuntu-latest
timeout-minutes: 135
timeout-minutes: 165
permissions:
contents: write
outputs:
Expand Down Expand Up @@ -90,9 +90,11 @@ jobs:
QC_LLM_MODEL: ${{ vars.QC_LLM_MODEL }}
QC_LLM_API_STYLE: ${{ vars.QC_LLM_API_STYLE }}
QC_LLM_MAX_TOKENS: ${{ vars.QC_LLM_MAX_TOKENS }}
QC_LLM_TIMEOUT_SECONDS: ${{ vars.QC_LLM_TIMEOUT_SECONDS }}
QC_LLM_MAX_CALLS: "800"
QC_LLM_TOTAL_DEADLINE_SECONDS: "7200"
# The total deadline covers the full release-docs preparation session.
# Each provider request separately defaults to a 180 second timeout.
QC_LLM_TIMEOUT_SECONDS: ${{ vars.QC_LLM_TIMEOUT_SECONDS || '180' }}
QC_LLM_MAX_CALLS: ${{ vars.QC_LLM_MAX_CALLS || '800' }}
QC_LLM_TOTAL_DEADLINE_SECONDS: ${{ vars.QC_LLM_TOTAL_DEADLINE_SECONDS || '9000' }}
QC_LLM_RUNTIME_ROOT: ${{ runner.temp }}/release-docs-runtime
run: |
uv run --frozen python ls/tools/localsetup.py --source-root . release-docs prepare \
Expand Down
6 changes: 3 additions & 3 deletions .localsetup-release.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@
"schema_version": 2,
"policy": "sequential-logical-slices",
"anchor": {
"commit": "51fbdf7c94f1f6087ecc69a99cf4d037a0c76117",
"version": "5.6.2",
"tag": "v5.6.2"
"commit": "561abefe0ab59029bf3ef1ebca76d73c119008e7",
"version": "4.44.1",
"tag": "v4.44.1"
},
"overrides": [],
"major_line": 4,
Expand Down
10 changes: 6 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,10 +56,12 @@ silently downgrade it. The one-time numbering reconciliation preserves published
v5.6.2 and its tag/assets as immutable while mapping its content to corrected
arithmetic 4.43.2 after the exact historical issue-100 MAJOR-to-MINOR
reconciliation. Branding maps to 4.44.0, and canonical repository-name policy
maps to 4.44.1. As of this reconciliation, 4.44.1 is not published or current.
The SDK paging and Agent Q v2/envelope compatibility breaks remain; corrected
numbering does not restore source or protocol compatibility, and 4.44.1 release
guidance must disclose both breaks clearly.
maps to 4.44.1. Published v4.44.1 was the first release under corrected 4.x
arithmetic and served as the baseline for the 4.44.2 patch. The v5.6.2 and
v4.22.9 historical release evidence remains preserved. The SDK paging and Agent Q
v2/envelope compatibility breaks remain; corrected numbering does not restore
source or protocol compatibility, and the v4.44.1 release guidance must disclose
both breaks clearly.

Use canonical version/release tooling and preserve source/receipt semantics.
If tooling cannot represent this sequence, implement and validate the missing
Expand Down
15 changes: 7 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
<a href="ls/docs/PLATFORM_REGISTRY.md"><img src="https://img.shields.io/badge/platforms-cursor%20%7C%20claude--code%20%7C%20codex%20%7C%20openclaw%20%7C%20kilo%20%7C%20opencode-1f6feb" alt="Supported platforms"></a>
</p>

**Version:** 4.44.1<br>
**Version:** 4.44.2<br>

**LocalSetup gives coding agents a repo-local operating layer.**

Expand All @@ -25,15 +25,14 @@ LocalSetup provides capability skills, executable workflow packages, explicit ad
Start with the [quickstart](ls/docs/QUICKSTART.md) or browse the [documentation](ls/docs/README.md). The [latest published release](https://github.com/CruxExperts/localsetup/releases/latest) provides release notes and downloads.

<!-- release-summary:start -->
## What's new in 4.44.1
## What's new in 4.44.2

LocalSetup 4.44.1 corrects the active release sequence to the authorized 4.x line and combines the approved GitHub visual identity, canonical repository spelling, and a safe installer fallback for mixed-major release tags. The published v5.6.2 tag and assets remain unchanged.
LocalSetup 4.44.2 improves release-documentation completion capacity for maintainers and aligns the release arithmetic with the verified published 4.44.1 anchor. The 4.x major-line lock and historical release evidence remain in force.

- **Corrected 4.x release line:** The verified history maps v5.6.2 content to corrected arithmetic 4.43.2, the branding feature to 4.44.0, and canonical repository-name policy to 4.44.1. The policy blocks MAJOR increments while the 4.x lock is active.
- **Theme-aware LocalSetup graphics:** The README hero, architecture diagram, and install-flow diagram use matching light and dark artwork with the approved mark, palette, and typography. The pinned renderer, JetBrains Mono files, source tokens, and font license make the exports reproducible.
- **Canonical name and release discovery:** Public repository policy uses `LocalSetup` spelling while retaining established commands and URLs. If release API lookup fails and stable tags span multiple major versions, the installer asks for `LOCALSETUP_BOOTSTRAP_REF` instead of guessing from numeric order.
- **Longer release-docs QC sessions:** Preparation defaults to 800 completion calls and a 9,000-second (150-minute) whole-session budget. The hosted publish job allows 165 minutes total, with a 15-minute grace period; individual provider requests use a separate 180-second fallback timeout.
- **Corrected 4.x release arithmetic:** Published v4.44.1 was the first release under corrected arithmetic and is the baseline for this patch. The v5.6.2 and v4.22.9 tags and assets remain unchanged, and major-version increments remain locked.

See the [4.44.1 release guide](ls/docs/releases/4.44.1.md) for compatibility, updating, and verification.
See the [4.44.2 release guide](ls/docs/releases/4.44.2.md) for compatibility, updating, and verification.
<!-- release-summary:end -->

The [4.4.0 guide](ls/docs/releases/4.4.0.md) remains available as release history.
Expand Down Expand Up @@ -84,7 +83,7 @@ Start with the [workflow packages guide](ls/docs/WORKFLOW_PACKAGES.md) for usage
<!-- facts-block:start -->
| Fact | Value |
|---|---|
| Current version | `4.44.1` |
| Current version | `4.44.2` |
| Supported platforms | `codex, claude-code, cursor, kilo, opencode, openclaw, github-copilot-cli, github-copilot-vscode, cline-cli, cline-vscode, amp-cli, goose-cli, pi-cli, hermes-agent, qwen-code-cli, kimi-cli, factory-droid, antigravity-app, gemini-cli, omp-cli` |
| Shipped skills | `105` |
| Workflow packages | `18` |
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
4.44.1
4.44.2
4 changes: 2 additions & 2 deletions ls/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# LocalSetup Framework Engine

**Version:** 4.44.1<br>
**Version:** 4.44.2<br>

`ls/` is the engine that makes the public LocalSetup promise real. It stores the framework code, shipped skills, workflow packages, platform templates, docs, tests, and install manifests that turn a repository into a portable agent workspace.

Expand All @@ -26,7 +26,7 @@ For the public product overview, start with the [root README](../README.md). Thi
LocalSetup-managed entries in consuming repositories are install output. Adapter directories may also contain project-owned skills, files, and symlinks; preserve that content in place. See [adapter ownership](docs/ADAPTER_OWNERSHIP.md).

<!-- release-link:start -->
Read the [current release guide](docs/releases/4.44.1.md) for LocalSetup 4.44.1, including compatibility, updating, and verification. Find downloads in the [latest published release](https://github.com/CruxExperts/localsetup/releases/latest).
Read the [current release guide](docs/releases/4.44.2.md) for LocalSetup 4.44.2, including compatibility, updating, and verification. Find downloads in the [latest published release](https://github.com/CruxExperts/localsetup/releases/latest).
<!-- release-link:end -->

## Install flow
Expand Down
6 changes: 3 additions & 3 deletions ls/core/release_docs/agent.py
Original file line number Diff line number Diff line change
Expand Up @@ -64,15 +64,15 @@ def _mapped_source_paths(plan: Mapping[str, Any], document: str) -> set[str] | N

@dataclass
class CompletionBudget:
"""Bound completion calls and wall time for one release-document preparation."""
"""Bound the whole release-docs preparation session; calls also have a per-request timeout."""
max_calls: int
deadline: float
calls: int = 0

@classmethod
def from_environment(cls) -> "CompletionBudget":
max_calls = int(os.environ.get("QC_LLM_MAX_CALLS", "240"))
seconds = int(os.environ.get("QC_LLM_TOTAL_DEADLINE_SECONDS", "1800"))
max_calls = int(os.environ.get("QC_LLM_MAX_CALLS", "800"))
seconds = int(os.environ.get("QC_LLM_TOTAL_DEADLINE_SECONDS", "9000"))
if max_calls < 1 or seconds < 1:
raise ValueError("QC_LLM_MAX_CALLS and QC_LLM_TOTAL_DEADLINE_SECONDS must be positive")
return cls(max_calls=max_calls, deadline=time.monotonic() + seconds)
Expand Down
2 changes: 1 addition & 1 deletion ls/docs/FEATURES.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This is the full public capability catalog for LocalSetup. The [root README](../
## Generated Facts

<!-- facts-block:start -->
- Current version: `4.44.1`
- Current version: `4.44.2`
- Supported platforms: `codex, claude-code, cursor, kilo, opencode, openclaw, github-copilot-cli, github-copilot-vscode, cline-cli, cline-vscode, amp-cli, goose-cli, pi-cli, hermes-agent, qwen-code-cli, kimi-cli, factory-droid, antigravity-app, gemini-cli, omp-cli`
- Shipped skills: `105`
- Workflow packages: `18`
Expand Down
4 changes: 2 additions & 2 deletions ls/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ This is the public documentation map for LocalSetup. Start here when you want th
## Generated Facts

<!-- facts-block:start -->
- Current version: `4.44.1`
- Current version: `4.44.2`
- Supported platforms: `codex, claude-code, cursor, kilo, opencode, openclaw, github-copilot-cli, github-copilot-vscode, cline-cli, cline-vscode, amp-cli, goose-cli, pi-cli, hermes-agent, qwen-code-cli, kimi-cli, factory-droid, antigravity-app, gemini-cli, omp-cli`
- Shipped skills: `105`
- Workflow packages: `18`
Expand Down Expand Up @@ -51,7 +51,7 @@ This is the public documentation map for LocalSetup. Start here when you want th
| [Harness automation](HARNESS_AUTOMATION.md) | Opt-in heartbeat activation, typed LSCli profiles, reserved actions/controller accounting, runtime artifacts, cron gating and command-policy boundaries. |

<!-- release-link:start -->
Read the [current release guide](releases/4.44.1.md) for LocalSetup 4.44.1, including compatibility, updating, and verification. Find downloads in the [latest published release](https://github.com/CruxExperts/localsetup/releases/latest).
Read the [current release guide](releases/4.44.2.md) for LocalSetup 4.44.2, including compatibility, updating, and verification. Find downloads in the [latest published release](https://github.com/CruxExperts/localsetup/releases/latest).
<!-- release-link:end -->

The [4.4.0 guide](releases/4.4.0.md) covers the earlier context and package consolidation.
Expand Down
6 changes: 3 additions & 3 deletions ls/docs/SKILLS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ version: 4.44
owner_package: generate-docs
localsetup_provenance:
schema_version: 1
source_provenance_hash: 2d1c85b74c29b27750a66ecac8106cff3bfe355a0459c12b81bf3e8deec4fbb8
source_provenance_hash: 6f5c26907e30347f7d8258fe7ff29b10992aca9cf0d71f73f979e3e7a1311b67
emitter: generate-docs
framework_version: 4.44.1
source_commit: cfb0f683ca9fea0b0c2c7b965089cbb39d43caea
framework_version: 4.44.2
source_commit: ac1e60dfd89c519b5b32cd32d4f4e0a3784000fe
artifact_sha256: 73c1afab3e2ac3b53857cd025f86bd7ca57a0668c3093542ff2c9b4faf16ed88
---
# Shipped skills catalog
Expand Down
21 changes: 12 additions & 9 deletions ls/docs/VERSIONING.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ LocalSetup uses the root `VERSION` file as the source of truth for the framework
## Current Version

- Source of truth: [`../../VERSION`](../../VERSION)
- Current value: `4.44.1`
- Current value: `4.44.2`
- Generated facts: [`_generated/facts.json`](_generated/facts.json)

## 4.x major-line lock and one-time numbering reconciliation
Expand All @@ -26,12 +26,13 @@ This is a one-time arithmetic correction. The already-published v5.6.2 tag and
assets remain immutable; that release's content maps to corrected arithmetic
4.43.2 after the exact historical issue-100 MAJOR-to-MINOR numbering
reconciliation. Branding maps to 4.44.0, followed by canonical
repository-name policy at 4.44.1. At the time of this reconciliation, 4.44.1
has not been published and is not current.
repository-name policy at 4.44.1. Published v4.44.1 was the first release under
corrected 4.x arithmetic and served as the baseline for the 4.44.2 patch. The
v5.6.2 and v4.22.9 historical release evidence remains preserved.

The SDK paging compatibility break and the Agent Q v2/envelope compatibility
break remain. Renumbering does not restore source or protocol compatibility.
The 4.44.1 release guidance must disclose both breaks clearly and must not imply
The v4.44.1 release guidance must disclose both breaks clearly and must not imply
that the numbering correction restored compatibility.

## Policy
Expand Down Expand Up @@ -214,11 +215,13 @@ receipt records the candidate commit and wheel digest. It does not select new
dependency versions. Runtime provisioning failure retains evidence and blocks the
affected run; it is never treated as successful qualification.
Optional qualification enforces a total completion-call budget. Its hosted
workflow allows two hours for model calls inside a 135-minute job, leaving runner
time for validation and evidence upload. Direct local runs retain the 30-minute
default unless the caller explicitly configures another positive deadline. An
oversized release stops before publication with an actionable scope/slice error;
incomplete audits are never recorded as successful coverage.
workflow allows 9,000 seconds (150 minutes) for model calls inside a 165-minute
job, leaving a 15-minute grace period for validation and evidence upload. Direct
local runs use the same 150-minute default unless the caller explicitly
configures another positive deadline. Each provider request has a separate
timeout; the hosted workflow fallback is 180 seconds. An oversized release
stops before publication with an actionable scope/slice error; incomplete audits
are never recorded as successful coverage.

Push the accepted source to `main` and wait for its required validation. Then
create and verify an OpenPGP-signed annotated `vX.Y.Z` tag at that exact commit,
Expand Down
6 changes: 3 additions & 3 deletions ls/docs/WORKFLOW_QUICK_REF.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ version: 4.44
owner_package: generate-docs
localsetup_provenance:
schema_version: 1
source_provenance_hash: 2d1c85b74c29b27750a66ecac8106cff3bfe355a0459c12b81bf3e8deec4fbb8
source_provenance_hash: 6f5c26907e30347f7d8258fe7ff29b10992aca9cf0d71f73f979e3e7a1311b67
emitter: generate-docs
framework_version: 4.44.1
source_commit: cfb0f683ca9fea0b0c2c7b965089cbb39d43caea
framework_version: 4.44.2
source_commit: ac1e60dfd89c519b5b32cd32d4f4e0a3784000fe
artifact_sha256: 393552d58b8412c44afc9fbbd0aff0975a19010d587d5779e0346ef5ff2e05a7
---
# Workflow quick reference
Expand Down
6 changes: 3 additions & 3 deletions ls/docs/WORKFLOW_REGISTRY.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ version: 4.44
owner_package: generate-docs
localsetup_provenance:
schema_version: 1
source_provenance_hash: 2d1c85b74c29b27750a66ecac8106cff3bfe355a0459c12b81bf3e8deec4fbb8
source_provenance_hash: 6f5c26907e30347f7d8258fe7ff29b10992aca9cf0d71f73f979e3e7a1311b67
emitter: generate-docs
framework_version: 4.44.1
source_commit: cfb0f683ca9fea0b0c2c7b965089cbb39d43caea
framework_version: 4.44.2
source_commit: ac1e60dfd89c519b5b32cd32d4f4e0a3784000fe
artifact_sha256: 0407568324660bae06808812eb701709399b3cff93d4d8903dddf688487a6745
---
# Workflow and module registry (LocalSetup)
Expand Down
Loading
Loading