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
8 changes: 4 additions & 4 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ jobs:
run: |
ext=""
if [[ "$TARGET" == *windows* ]]; then ext=".exe"; fi
asset="ctrlissues-v0.1.1-${LABEL}.zip"
asset="ctrlissues-v0.1.2-${LABEL}.zip"
python scripts/package.py --source . --binary "plugins/ctrlissues/runtime/target/${TARGET}/release/ctrlissues${ext}" --target "$TARGET" --output "$asset"
python scripts/validate-package.py --package "$asset"
python - "$asset" <<'PY'
Expand All @@ -74,9 +74,9 @@ jobs:
python scripts/package-smoke.py --package "$asset" --checksum "$asset.sha256"
- uses: actions/upload-artifact@v4
with:
name: ctrlissues-v0.1.1-${{ matrix.label }}
name: ctrlissues-v0.1.2-${{ matrix.label }}
path: |
ctrlissues-v0.1.1-${{ matrix.label }}.zip
ctrlissues-v0.1.1-${{ matrix.label }}.zip.sha256
ctrlissues-v0.1.2-${{ matrix.label }}.zip
ctrlissues-v0.1.2-${{ matrix.label }}.zip.sha256
install.sh
if-no-files-found: error
5 changes: 4 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,10 @@ task cursor and record the next unresolved action.

Astra xhigh remains the primary reasoner in the target profile. it reads the
sources, decides scope, assigns bounded work, observes results, and accepts
proof. use a helper only when the task benefits from one. give a worker the
proof. prefer gpt-6.1-sol at low effort for delegated work. reserve gpt-6-luna
at low effort for extremely narrow literal extraction or edits. preserve an
explicit higher-effort state, concurrency, protocol, or hard-question cut.
use a helper only when the task benefits from one. give a worker the
exact target, source, allowed files, completion check, and recovery boundary.
the worker returns a diff, command results, and artifact paths. no model score
or worker report completes a task by itself. keep RecentlyDivorced separate.
Expand Down
14 changes: 10 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,20 +25,20 @@ one browser profile ──► one CtrlIssues action owner

## install

The v0.1.1 release installer selects a Linux x86_64 musl or macOS package and
The v0.1.2 release installer selects a Linux x86_64 musl or macOS package and
checks its SHA-256 file. Python 3.11 or newer is needed for installation and
the Python backend. Rust is needed only when building from source.

Run it with:

```sh
curl -fsSL https://github.com/lmtlssss/CtrlIssues/releases/download/v0.1.1/install.sh | sh
curl -fsSL https://github.com/lmtlssss/CtrlIssues/releases/download/v0.1.2/install.sh | sh
```

Windows users can install a local package with Python 3.11 or newer:

```powershell
python scripts/install.py --package ctrlissues-v0.1.1-windows-x86_64.zip
python scripts/install.py --package ctrlissues-v0.1.2-windows-x86_64.zip
```

For a source install, use Rust and Python 3.11 or newer:
Expand All @@ -56,7 +56,13 @@ and to trust CtrlIssues hooks. Details and isolated install options are in
## use

Use Codex with Astra xhigh as the configured primary. Start with the person's
goal. Substantial work gets an ordered plan; the agent finishes the current
goal. Prefer `gpt-6.1-sol` at low effort for delegated work. Reserve
`gpt-6-luna` at low effort for extremely narrow literal extraction or edits.
Preserve explicit higher-effort state, concurrency, protocol, and hard-question
cuts. The [helper policy](plugins/ctrlissues/helper-policy.json) records this
choice; native Codex applies it, and hooks never switch models.

Substantial work gets an ordered plan; the agent finishes the current
layer and accepts a result only with a current receipt. Short direct tasks need
no blueprint. Later steers revise the same task and retain valid completed work.

Expand Down
4 changes: 2 additions & 2 deletions docs/install.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Install CtrlIssues

The v0.1.1 package contains the native core, Python backend, hooks, skill, and plugin manifest in one immutable versioned payload. It does not replace the Codex executable or add a model catalog. Python 3.11 or newer is needed for installation and the Python backend; Rust is needed only to build from source.
The v0.1.2 package contains the native core, Python backend, hooks, skill, and plugin manifest in one immutable versioned payload. It does not replace the Codex executable or add a model catalog. Python 3.11 or newer is needed for installation and the Python backend; Rust is needed only to build from source.

## Build a package

Expand Down Expand Up @@ -34,7 +34,7 @@ data; it does not snapshot or restore the whole Codex profile.
On Linux x86_64 and macOS arm64/x86_64, the release bootstrap selects the matching versioned package, downloads that package and its `.sha256` file once, checks the digest, and then runs the bundled installer. For example:

```sh
curl -fsSL https://github.com/lmtlssss/CtrlIssues/releases/download/v0.1.1/install.sh | sh
curl -fsSL https://github.com/lmtlssss/CtrlIssues/releases/download/v0.1.2/install.sh | sh
```

Windows users can pass a built package to `python scripts/install.py --package FILE.zip`, or use `install.ps1` with a local checkout and `--binary FILE.exe`.
Expand Down
2 changes: 1 addition & 1 deletion install.sh
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#!/bin/sh
set -eu
VERSION=0.1.1
VERSION=0.1.2
ROOT=
if [ -f "$0" ]; then
CANDIDATE=$(CDPATH= cd -- "$(dirname -- "$0")" 2>/dev/null && pwd || true)
Expand Down
2 changes: 1 addition & 1 deletion plugins/ctrlissues/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "ctrlissues",
"version": "0.1.1",
"version": "0.1.2",
"description": "for agents with executive dysfunction.",
"author": {
"name": "lmtlssss"
Expand Down
18 changes: 18 additions & 0 deletions plugins/ctrlissues/helper-policy.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"schema": "ctrlissues.helper-policy.v1",
"primary": {
"model": "gpt-6-astra",
"reasoning_effort": "xhigh"
},
"default_helper": {
"model": "gpt-6.1-sol",
"reasoning_effort": "low"
},
"literal_helper": {
"model": "gpt-6-luna",
"reasoning_effort": "low",
"scope": "Extremely narrow literal extraction or edits with exact sources and a fixed completion condition."
},
"higher_effort": "Preserve explicit higher-effort state, concurrency, protocol, and hard-question cuts. Primary chooses the bounded helper or performs the cut.",
"authority": "Advisory delegation policy. Native Codex owns model selection, context, and permissions. No hook changes models."
}
8 changes: 8 additions & 0 deletions plugins/ctrlissues/skills/ctrlissues/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,12 @@ Use the native `ctrlissues` command for task state and proof receipts. Do not cr
- Read [execution.md](references/execution.md) when you need typed work, decisions, semantic checks, or compact execution reports.
- Read [hands.md](references/hands.md) when a task needs a bounded browser loop.

Use `gpt-6.1-sol` at low effort as the preferred delegated helper. Reserve
`gpt-6-luna` at low effort for extremely narrow literal extraction or edits.
Give every helper exact sources, allowed files, a completion condition, and a
recovery boundary. Preserve an explicit higher-effort cut for state, concurrency,
protocol work, or a hard question. Primary can perform that cut directly.
The [helper policy](../../helper-policy.json) is advisory; native Codex owns
selection and permissions. Hooks do not switch models.

The native core owns task identity, revisions, checks, and lifecycle hooks. The optional Python backend owns bounded typed work and semantic calls. A successful command is an execution result; accept an application effect only when its explicit postcondition or independent readback proves it.
8 changes: 4 additions & 4 deletions scripts/install.py
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ def codex(binary, env, *args):
return p.stdout

def validate_contents(files: dict[str, bytes], meta: dict):
if meta.get("format") != "ctrlissues.package.v1" or meta.get("name") != NAME or meta.get("version") != "0.1.1": raise ValueError("package_identity")
if meta.get("format") != "ctrlissues.package.v1" or meta.get("name") != NAME or meta.get("version") != "0.1.2": raise ValueError("package_identity")
if meta.get("target") not in TARGETS: raise ValueError("package_target")
hashes = meta.get("files")
if not isinstance(hashes, dict) or set(hashes) != set(files): raise ValueError("package_inventory")
Expand All @@ -69,7 +69,7 @@ def validate_contents(files: dict[str, bytes], meta: dict):
hooks=json.loads(files["plugins/ctrlissues/hooks/hooks.json"])
market=json.loads(files[".agents/plugins/marketplace.json"])
skill=files["plugins/ctrlissues/skills/ctrlissues/SKILL.md"].decode("utf-8")
if manifest.get("name")!=NAME or manifest.get("version")!="0.1.1": raise ValueError("plugin_manifest")
if manifest.get("name")!=NAME or manifest.get("version")!="0.1.2": raise ValueError("plugin_manifest")
matches=[x for x in market.get("plugins",[]) if isinstance(x,dict) and x.get("name")==NAME]
if len(matches)!=1 or matches[0].get("source")!={"source":"local","path":"./plugins/ctrlissues"}: raise ValueError("marketplace_entry")
if not all(k in matches[0].get("policy",{}) for k in ("installation","authentication")) or not matches[0].get("category"): raise ValueError("marketplace_policy")
Expand Down Expand Up @@ -141,7 +141,7 @@ def collect_source(source: Path, binary: Path):
hashes={n:hashlib.sha256(b).hexdigest() for n,b in sorted(files.items())}
generation=hashlib.sha256()
for name, digest in sorted(hashes.items()): generation.update(name.encode()+b"\0"+bytes.fromhex(digest))
meta={"format":"ctrlissues.package.v1","name":NAME,"version":"0.1.1","target":target,"generation":generation.hexdigest(),"files":hashes}
meta={"format":"ctrlissues.package.v1","name":NAME,"version":"0.1.2","target":target,"generation":generation.hexdigest(),"files":hashes}
validate_contents(files,meta)
return files,meta

Expand Down Expand Up @@ -198,7 +198,7 @@ def call(method,params):
if "error" in msg: raise RuntimeError("app_server_rejected:"+method)
return msg.get("result",{})
try:
call("initialize",{"clientInfo":{"name":NAME,"version":"0.1.1"},"capabilities":{"experimentalApi":True}})
call("initialize",{"clientInfo":{"name":NAME,"version":"0.1.2"},"capabilities":{"experimentalApi":True}})
p.stdin.write(json.dumps({"method":"initialized","params":{}})+"\n"); p.stdin.flush()
result=call("hooks/list",{"cwds":[str((cwd or Path.cwd()).resolve())]})
hooks=[h for group in result.get("data",[]) for h in group.get("hooks",[]) if h.get("pluginId")==PLUGIN_ID]
Expand Down
4 changes: 2 additions & 2 deletions scripts/package.py
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ def collect(root: Path, binary: Path, target: str) -> dict[str, bytes]:
if not path.is_file() or path.is_symlink(): raise ValueError("package_file_missing:" + name)
files[name] = path.read_bytes()
info = json.loads(files["plugins/ctrlissues/.codex-plugin/plugin.json"])
if info.get("name") != "ctrlissues" or info.get("version") != "0.1.1": raise ValueError("plugin_manifest_mismatch")
if info.get("name") != "ctrlissues" or info.get("version") != "0.1.2": raise ValueError("plugin_manifest_mismatch")
if not binary.is_file() or binary.is_symlink(): raise ValueError("binary_missing_or_unsafe")
suffix = ".exe" if target.endswith("windows-msvc") else ""
binary_name = "plugins/ctrlissues/runtime/bin/ctrlissues" + suffix
Expand All @@ -63,7 +63,7 @@ def package(root: Path, binary: Path, target: str, output: Path) -> dict:
files = collect(root, binary, target)
hashes = {name: hashlib.sha256(body).hexdigest() for name, body in sorted(files.items())}
generation = digest_inventory(files)
metadata = {"format": FORMAT, "name": "ctrlissues", "version": "0.1.1",
metadata = {"format": FORMAT, "name": "ctrlissues", "version": "0.1.2",
"target": target, "generation": generation, "files": hashes}
output.parent.mkdir(parents=True, exist_ok=True)
tmp = output.with_name("." + output.name + ".tmp")
Expand Down
6 changes: 3 additions & 3 deletions scripts/validate-package.py
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ def validate_tree(root: Path, require_binary=False):
hooks = json.loads((root / "plugins/ctrlissues/hooks/hooks.json").read_text(encoding="utf-8"))
skill = (root / "plugins/ctrlissues/skills/ctrlissues/SKILL.md").read_text(encoding="utf-8")
entries = [p for p in market.get("plugins", []) if isinstance(p, dict) and p.get("name") == "ctrlissues"]
if manifest.get("name") != "ctrlissues" or manifest.get("version") != "0.1.1": raise ValueError("plugin_manifest")
if manifest.get("name") != "ctrlissues" or manifest.get("version") != "0.1.2": raise ValueError("plugin_manifest")
if len(entries) != 1 or entries[0].get("source") != {"source": "local", "path": "./plugins/ctrlissues"}:
raise ValueError("marketplace_entry")
if not all(k in entries[0].get("policy", {}) for k in ("installation", "authentication")) or not entries[0].get("category"):
Expand Down Expand Up @@ -62,7 +62,7 @@ def validate_package(path: Path):
names.add(name)
if "ctrlissues-package.json" not in names: raise ValueError("package_metadata")
metadata = json.loads(zf.read("ctrlissues-package.json"))
if metadata.get("format") != FORMAT or metadata.get("name") != "ctrlissues" or metadata.get("version") != "0.1.1":
if metadata.get("format") != FORMAT or metadata.get("name") != "ctrlissues" or metadata.get("version") != "0.1.2":
raise ValueError("package_identity")
if metadata.get("target") not in TARGETS: raise ValueError("package_target")
files = metadata.get("files")
Expand All @@ -87,7 +87,7 @@ def main(argv=None):
group.add_argument("--package", type=Path)
args = parser.parse_args(argv)
result = validate_tree(args.source) if args.source else validate_package(args.package)
print(json.dumps({"status": "valid", "name": "ctrlissues", "version": "0.1.1",
print(json.dumps({"status": "valid", "name": "ctrlissues", "version": "0.1.2",
"generation": result.get("generation")}, sort_keys=True))


Expand Down
Loading