diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 8abc4a1..2815369 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -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' @@ -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 diff --git a/AGENTS.md b/AGENTS.md index 70cb2f1..bfedaec 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. diff --git a/README.md b/README.md index b1fc3f2..8c62c94 100644 --- a/README.md +++ b/README.md @@ -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: @@ -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. diff --git a/docs/install.md b/docs/install.md index 639c485..b77afbc 100644 --- a/docs/install.md +++ b/docs/install.md @@ -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 @@ -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`. diff --git a/install.sh b/install.sh index a9fccd4..b0618a0 100755 --- a/install.sh +++ b/install.sh @@ -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) diff --git a/plugins/ctrlissues/.codex-plugin/plugin.json b/plugins/ctrlissues/.codex-plugin/plugin.json index 4bee1ad..e87ef53 100644 --- a/plugins/ctrlissues/.codex-plugin/plugin.json +++ b/plugins/ctrlissues/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "ctrlissues", - "version": "0.1.1", + "version": "0.1.2", "description": "for agents with executive dysfunction.", "author": { "name": "lmtlssss" diff --git a/plugins/ctrlissues/helper-policy.json b/plugins/ctrlissues/helper-policy.json new file mode 100644 index 0000000..7f8fb07 --- /dev/null +++ b/plugins/ctrlissues/helper-policy.json @@ -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." +} diff --git a/plugins/ctrlissues/skills/ctrlissues/SKILL.md b/plugins/ctrlissues/skills/ctrlissues/SKILL.md index cb9c16d..973b77c 100644 --- a/plugins/ctrlissues/skills/ctrlissues/SKILL.md +++ b/plugins/ctrlissues/skills/ctrlissues/SKILL.md @@ -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. diff --git a/scripts/install.py b/scripts/install.py index 6625fa1..f07c1a2 100644 --- a/scripts/install.py +++ b/scripts/install.py @@ -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") @@ -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") @@ -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 @@ -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] diff --git a/scripts/package.py b/scripts/package.py index 8f3738c..b2e9ff2 100644 --- a/scripts/package.py +++ b/scripts/package.py @@ -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 @@ -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") diff --git a/scripts/validate-package.py b/scripts/validate-package.py index c052ca7..ccf42f2 100644 --- a/scripts/validate-package.py +++ b/scripts/validate-package.py @@ -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"): @@ -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") @@ -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))