Releases: HF-CYGG/CtxSift
Release list
CtxSift v1.3.0-alpha.0
v1.3.0-alpha.0 Release Notes
Summary
CtxSift v1.3.0-alpha.0 adds editor and web workflow examples while keeping the
CLI as the source of truth. The root CLI remains dependency-light and compatible
with the v1 JSON and Markdown outputs.
Release tag:
v1.3.0-alpha.0
Highlights
- VS Code command example in
examples/vscode-command. - Public web demo example in
examples/public-web-demo. - Web demo accepts only public
https://github.com/owner/repoURLs. - Example workflows default to
profile: private. pnpm test:examplessmoke-checks example argument construction and URL
safety.
Verification
pnpm lintpnpm typecheckpnpm testpnpm test:e2epnpm test:examplespnpm buildpnpm pack --dry-runpnpm run release:checkpnpm bench:fixturespnpm bench:reportpnpm audit --audit-level high --registry https://registry.npmjs.org
Release Metadata
- Version:
1.3.0-alpha.0 - Tag:
v1.3.0-alpha.0 - Release type: alpha prerelease
CtxSift v1.2.0-alpha.0
v1.2.0-alpha.0 Release Notes
Summary
CtxSift v1.2.0-alpha.0 is the GitHub Action hardening alpha. It keeps the CLI
and bundle schema compatible while formalizing the artifact-first pull request
workflow and optional sticky PR summary comments.
Release tag:
v1.2.0-alpha.0
Highlights
- Root composite
action.ymlfor review-context generation. - Default artifact-only mode with Markdown and JSON review bundles.
- Default workflow permission remains
contents: read. - Sticky PR comments remain opt-in through
comment: "true"and
github-token. - Sticky comments contain only review metadata and never embed source chunks.
Verification
pnpm lintpnpm typecheckpnpm testpnpm test:e2epnpm buildpnpm pack --dry-runpnpm run release:checkpnpm bench:fixturespnpm bench:reportpnpm audit --audit-level high --registry https://registry.npmjs.org
Release Metadata
- Version:
1.2.0-alpha.0 - Tag:
v1.2.0-alpha.0 - Release type: alpha prerelease
CtxSift v1.1.0-alpha.0
v1.1.0-alpha.0 Release Notes
Summary
CtxSift v1.1.0-alpha.0 is the workspace-aware alpha release candidate. It keeps
the CLI behavior compatible with v1.0.0 while adding package/workspace context,
benchmark evidence, and GitHub Action documentation for review bundles.
Release tag:
v1.1.0-alpha.0
Highlights
- Workspace graph alpha for pnpm and
package.jsonworkspaces. - Package-level reasons and workspace score components in selected files.
- Optional workspace graph output through
--workspace-graph. - Security profiles through
--profile balanced|private|strict. - Local benchmark fixtures and generated Markdown/JSON benchmark reports.
- Root composite GitHub Action documentation for artifact-first PR review context.
Benchmark Snapshot
The alpha benchmark report covers 6 deterministic local fixtures:
- Average relevant hit rate: 83.3%.
- Average token saving ratio: 39.8%.
- Average workspace package hit rate: 33.3%.
See ../benchmark-report.md and
../benchmark-report.json for the generated reports.
Verification
pnpm lintpnpm typecheckpnpm testpnpm test:e2epnpm buildpnpm pack --dry-runpnpm run release:checkpnpm bench:fixturespnpm bench:reportpnpm audit --audit-level high --registry https://registry.npmjs.org
Environment Notes
Some Windows sandbox runs can fail at child-process startup with spawn EPERM or
spawnSync node EPERM. The release gate was rerun for those commands in an
elevated local context and passed.
Release Metadata
- Version:
1.1.0-alpha.0 - Tag:
v1.1.0-alpha.0 - Release type: alpha prerelease
CtxSift v1.0.0
CtxSift v1.0.0
首个稳定版本。CtxSift 是一个问题感知型上下文打包器,用于按任务问题筛选、脱敏并导出最相关的仓库文件,适用于 Codex、ChatGPT、Claude 等 AI 编程工具。
主要能力
- 本地仓库与公开 GitHub 仓库输入:
ctxsift --repo . --ask "Where does auth start?" - 问题感知型文件排序,输出每个入选文件的选择理由。
- Markdown 与 JSON Schema 1.0 双格式上下文包。
- Diff-aware review bundle:
ctxsift --repo . --diff main...HEAD --mode review - Token 预算控制、超预算文件裁剪与 dropped-file 摘要。
- 默认安全排除与基础 secret redaction,避免
.env、密钥、证书和常见 token 明文进入 bundle。 - GitHub Actions 示例,用于生成 PR review context artifact。
验证
pnpm run release:check通过。- Vitest:13 个测试文件、27 个测试通过。
- E2E、TypeScript build、pack dry-run 通过。
pnpm audit --audit-level high:No known vulnerabilities found。- 已用 Y-Link、VSCode、Kubernetes、Django、Spring Framework 等真实复杂仓库完成大仓测试。
安装与使用
npm install -g ctxsift
ctxsift --repo . --ask "Where does auth start?"
ctxsift --repo . --format json --out ctxbundle.json --ask "How does routing work?"