holycodex 0.13.0 → 0.13.1-dev.205.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +8 -30
- package/package.json +2 -2
package/dist/cli.js
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import process$1 from "node:process";
|
|
2
|
-
import { createInterface } from "node:readline/promises";
|
|
3
2
|
import { access, copyFile, cp, lstat, mkdir, mkdtemp, readFile, readdir, readlink, rename, rm, stat, writeFile } from "node:fs/promises";
|
|
4
3
|
import { homedir, tmpdir } from "node:os";
|
|
5
4
|
import { delimiter, dirname, join } from "node:path";
|
|
@@ -4392,7 +4391,7 @@ function superRefine(fn, params) {
|
|
|
4392
4391
|
}
|
|
4393
4392
|
//#endregion
|
|
4394
4393
|
//#region packages/cli/src/catalog.ts
|
|
4395
|
-
var VERSION = "0.13.
|
|
4394
|
+
var VERSION = "0.13.1-dev.205.1";
|
|
4396
4395
|
var SKILLS = [
|
|
4397
4396
|
"ast-grep",
|
|
4398
4397
|
"babysit-ci",
|
|
@@ -5062,7 +5061,7 @@ var GENERATED_RUNTIMES = [
|
|
|
5062
5061
|
"workflow-evaluator.js"
|
|
5063
5062
|
];
|
|
5064
5063
|
var WINDOWS_SHELL_POLICY = "On native Windows, run every shell command through the bundled Git Bash launcher, including Git, package, build, test, script and POSIX commands. Never execute task commands through PowerShell or cmd. If Git Bash cannot be resolved, stop and report the blocker. On non-Windows, use the native shell normally.";
|
|
5065
|
-
var LITE_WRITING_POLICY = "Communicate grammatically and concisely. Omit filler, hedging, repetition, decoration, self-reference, style announcements and tool narration. Preserve exact technical terms, APIs, commands, paths, errors and commit keywords. Use fuller grammar for safety, ambiguity, clarification and ordered instructions. Apply this policy only to agent communication, never to literal authored or transformed content, UI or accessibility labels, help text, errors, logs, tests, fixtures, documentation, comments, commit or PR text, authored prompts, translations, quotations, generated content, public APIs, or existing repository and product voice.";
|
|
5064
|
+
var LITE_WRITING_POLICY = "Communicate grammatically and concisely. Omit filler, hedging, repetition, decoration, self-reference, style announcements and tool narration. Preserve exact technical terms, APIs, commands, paths, errors and commit keywords. Use fuller grammar for safety, ambiguity, clarification and ordered instructions. plus-low favors retained context, compact structured outcomes, Luna-local loops and synthesis, sufficient discovery, and genuine concurrency without budget changes. Apply this policy only to agent communication, never to literal authored or transformed content, UI or accessibility labels, help text, errors, logs, tests, fixtures, documentation, comments, commit or PR text, authored prompts, translations, quotations, generated content, public APIs, or existing repository and product voice.";
|
|
5066
5065
|
var CONTEXT7_POLICY = "Within assigned scope, use the Context7 CLI skill first for current library, framework, SDK and API documentation. Use live web search for releases, dates, broader research, missing Context7 coverage and corroboration. Context7 does not authorize scope expansion.";
|
|
5067
5066
|
/** Returns packaged runtime files required on a platform. */
|
|
5068
5067
|
function requiredPackageRuntimes(platform) {
|
|
@@ -6754,6 +6753,7 @@ function executableOnPath(name) {
|
|
|
6754
6753
|
var CORE_INSTRUCTIONS = "HolyCodex: Root is user-facing. Before updates, classify intent and load required skills. Start with \"I detect [intent] intent — [action].\" Choose the accurate intent naturally; no fixed intent taxonomy applies. `plan` and `plan-review` instead own their exact heading and intent as the first visible block; no other mode prints a heading. Do not conceal orchestration. Give concise updates naming each specialist type and what it will do, such as \"Explorer maps X\", \"Librarian verifies Y\", or \"Worker implements Z\". Do not disclose Root orchestration mechanics or explain why delegation is running unless asked. Skills govern method only. Root owns interaction, intent, scope, architecture, product choices, ambiguity, integration, external state, and final judgment and verification. Root is not another implementation branch: evaluate specialist output against scope, fixed architecture, user decisions, repository conventions, and proof; reject or repair weak output and integrate only accepted work. On every plan other than Go, always delegate at least one bounded task through a CLI workflow. Never skip delegation because direct local work is cheaper or sufficient, and never invoke regular Codex collaboration subagents. If the workflow runtime is unavailable or cannot perform the required operation, report the blocker instead of bypassing delegation. Missing task-child visibility is not a reason to avoid workflows. Go does not support workflows, so Root works directly without specialist subagents. A task may contain multiple sequential workflows. Prefer the smallest useful fan-out, stop discovery when evidence is sufficient, and avoid duplicate investigation. The selected plan is authoritative: enforce its permitted model routes for each agent and stage, low verbosity, Fast as the only service-tier variation, concurrency, soft target calls, hard maximum calls, workflow depth, retries, loop iterations, fan-out, projected usage, and soft-size guidance. Root should remain near target calls and exceed them only when intermediate evidence justifies more work; the hard maximum is only a safety and quota ceiling. Larger plans do not automatically consume larger allowances. Keep explorer, librarian, and worker selectable only where the plan permits. Root owns workflow integration and final proof. After any code or manifest implementation, Root loads `code-review` exactly once before final response; it also loads `code-review` for a user-requested snippet, file, directory, diff, patch, or PR review. That skill owns the final audit, repair, proportional checks and reruns, reinspection, diff, and status. Classify unknowns: delegate facts, ask material decisions, and state and use safe reversible defaults. Whenever Root needs user input or would ask any question, it must use `request_user_input` when that tool is available, in every scenario and mode. Root must never stop or reply with a plain-text question when the tool is available. If the tool is unavailable, use a safe reversible default where possible or report a non-question blocker. Never repeat questions or ask discoverable facts. Root must use `request_user_input` immediately before committing, pushing, creating or moving tags, building or compiling, publishing, deploying, destructive or irreversible actions, permission changes, financial actions, sending, or any other externally visible action. Earlier general authorization does not replace this immediate approval unless the user explicitly authorized that exact action in the current turn. Root controls browser and native desktop UI itself. Explorer is repository-read-only, Librarian research-only, and Worker cannot alter dashboards, accounts, permissions, or external state. Specialists never delegate, broaden, review, or make final judgments.";
|
|
6755
6754
|
var NATIVE_IO_INSTRUCTIONS = "For `plan` and `plan-review` headings, never print provisionally. Never delegate browser or computer control. For frontend creation, redesign, or visual verification, use installed Build Web Apps `frontend-app-builder` for concept, approval, implementation, and visual verification. For authorized security reviews, audits, scans, threat models, vulnerabilities, or attack paths, use matching installed Codex Security plugin skills. Use these capabilities instead of manual-click instructions, shell-as-GUI, or public research as a substitute for authenticated control. Use Codex native `apply_patch` for workspace file creation, updates, moves, and deletion. Use available native read or shell tools for file inspection and repository search. Do not re-read files only to verify a successful `apply_patch` call.";
|
|
6756
6755
|
var COMPUTER_USE_INSTRUCTIONS = "For native desktop tasks, use the available Computer Use capability.";
|
|
6756
|
+
var ROOT_LUNA_POLICY = "Root is the judgment and control plane: own interaction, scope, architecture, product and risk decisions, workflow integration, material ambiguity, external state, and the final decision. Luna specialists are bounded execution context: Explorer maps sufficient repository facts, Librarian verifies assigned current facts, and Worker implements, integrates, inspects diffs, runs checks, performs mechanical repair and retest, routine review, evidence compression, and optional synthesis. Root accepts successful structured Luna evidence without rereading or re-verifying it; material architecture, product, scope, risk, or contradictory-evidence decisions return to Root. On plus-low, prefer retained context, compact outcomes, Luna-local loops and synthesis, sufficient discovery, and genuine concurrency without changing plan quotas. Structured substantive outcomes are the branching contract, not prose parsing. Escalate Luna high to xhigh to max only when the evidence justifies it and the active plan permits the route; max insufficiency returns compact evidence to Root and never creates a Sol specialist.";
|
|
6757
6757
|
var CODE_REVIEW_ACTIVATION_POLICY = "After loading `code-review`, its first visible line is **CODE REVIEW MODE ACTIVATED**.";
|
|
6758
6758
|
/** Gets core instructions with platform and active agent-capacity context. */
|
|
6759
6759
|
function coreInstructions(platform, capacity, computerUseEnabled = false) {
|
|
@@ -6761,7 +6761,7 @@ function coreInstructions(platform, capacity, computerUseEnabled = false) {
|
|
|
6761
6761
|
const depth = capacity?.maxDepth;
|
|
6762
6762
|
const capacityInstructions = threads === void 0 || depth === void 0 ? "Before delegation, use active collaboration tool instructions as the authoritative agent-capacity limit." : `Host agent capacity: agents.max_concurrent_threads_per_session=${threads} includes Root. The host nesting limit is ${depth}; the active plan's maxCalls is the hard workflow call ceiling and targetCalls is soft planning guidance. Its lower concurrency, depth, and fan-out limits remain authoritative. On plans other than Go, Root always delegates at least one bounded task through a CLI workflow and reports a blocker if that runtime is unavailable or cannot perform the operation. Go does not support workflows, so Root works directly without specialist subagents.`;
|
|
6763
6763
|
const platformInstructions = platform === "win32" ? ` ${WINDOWS_SHELL_POLICY}` : "";
|
|
6764
|
-
return `${CORE_INSTRUCTIONS} ${LITE_WRITING_POLICY} ${CONTEXT7_POLICY} ${NATIVE_IO_INSTRUCTIONS}${computerUseEnabled ? ` ${COMPUTER_USE_INSTRUCTIONS}` : ""} ${CODE_REVIEW_ACTIVATION_POLICY} ${capacityInstructions}${platformInstructions}`;
|
|
6764
|
+
return `${CORE_INSTRUCTIONS} ${ROOT_LUNA_POLICY} ${LITE_WRITING_POLICY} ${CONTEXT7_POLICY} ${NATIVE_IO_INSTRUCTIONS}${computerUseEnabled ? ` ${COMPUTER_USE_INSTRUCTIONS}` : ""} ${CODE_REVIEW_ACTIVATION_POLICY} ${capacityInstructions}${platformInstructions}`;
|
|
6765
6765
|
}
|
|
6766
6766
|
//#endregion
|
|
6767
6767
|
//#region packages/cli/src/doctor.ts
|
|
@@ -7001,7 +7001,7 @@ async function install(options, runtime = defaultRuntime) {
|
|
|
7001
7001
|
const plan = options.plan ?? "plus-low";
|
|
7002
7002
|
const target = paths();
|
|
7003
7003
|
const existingConfig = await readText(target.config);
|
|
7004
|
-
const computerUseChoice =
|
|
7004
|
+
const computerUseChoice = resolveComputerUseChoice(options);
|
|
7005
7005
|
const root = backupRoot();
|
|
7006
7006
|
notify(options, "backup", "Backing up existing installation", "running");
|
|
7007
7007
|
const configBackup = await backup(target.config, root);
|
|
@@ -7104,13 +7104,8 @@ async function install(options, runtime = defaultRuntime) {
|
|
|
7104
7104
|
buildWebApps
|
|
7105
7105
|
};
|
|
7106
7106
|
}
|
|
7107
|
-
|
|
7108
|
-
|
|
7109
|
-
const managed = readManagedComputerUse(existingConfig);
|
|
7110
|
-
if (managed !== void 0) return managed;
|
|
7111
|
-
if (options.promptComputerUse !== void 0) return options.promptComputerUse();
|
|
7112
|
-
if (options.interactive === true) throw new Error("Interactive Computer Use selection is unavailable on this surface.");
|
|
7113
|
-
throw new Error("Computer Use choice is required for a new non-interactive installation. Re-run with --computer-use or --no-computer-use.");
|
|
7107
|
+
function resolveComputerUseChoice(options) {
|
|
7108
|
+
return options.computerUse ?? "disabled";
|
|
7114
7109
|
}
|
|
7115
7110
|
function computerUseFailure(result) {
|
|
7116
7111
|
const reason = result.reason.replaceAll("-", " ");
|
|
@@ -7148,7 +7143,7 @@ async function restoreTarget(target, source) {
|
|
|
7148
7143
|
}
|
|
7149
7144
|
async function removeObsoleteVersionCaches(cacheRoot) {
|
|
7150
7145
|
if (!await exists(cacheRoot)) return;
|
|
7151
|
-
for (const entry of await readdir(cacheRoot)) if (entry !== "0.13.
|
|
7146
|
+
for (const entry of await readdir(cacheRoot)) if (entry !== "0.13.1-dev.205.1") await rm(join(cacheRoot, entry), {
|
|
7152
7147
|
recursive: true,
|
|
7153
7148
|
force: true
|
|
7154
7149
|
});
|
|
@@ -7406,14 +7401,9 @@ async function main() {
|
|
|
7406
7401
|
process$1.stdout.write(`${VERSION}\n`);
|
|
7407
7402
|
return;
|
|
7408
7403
|
}
|
|
7409
|
-
const interactiveInstall = parsed.command === "install" && parsed.noTui === false && parsed.json === false && process$1.stdin.isTTY === true && process$1.stdout.isTTY === true;
|
|
7410
7404
|
const options = {
|
|
7411
7405
|
autonomy: parsed.autonomy,
|
|
7412
7406
|
...parsed.computerUse === void 0 ? {} : { computerUse: parsed.computerUse },
|
|
7413
|
-
...parsed.command === "install" ? {
|
|
7414
|
-
interactive: interactiveInstall,
|
|
7415
|
-
...interactiveInstall ? { promptComputerUse } : {}
|
|
7416
|
-
} : {},
|
|
7417
7407
|
fast: parsed.fast,
|
|
7418
7408
|
json: parsed.json,
|
|
7419
7409
|
plan: parsed.plan,
|
|
@@ -7431,18 +7421,6 @@ async function main() {
|
|
|
7431
7421
|
const result = parsed.command === "install" ? await install(options) : await cleanup(options);
|
|
7432
7422
|
process$1.stdout.write(parsed.json ? `${JSON.stringify(result)}\n` : renderRunResult(result, stdoutColor));
|
|
7433
7423
|
}
|
|
7434
|
-
async function promptComputerUse() {
|
|
7435
|
-
const readline = createInterface({
|
|
7436
|
-
input: process$1.stdin,
|
|
7437
|
-
output: process$1.stdout
|
|
7438
|
-
});
|
|
7439
|
-
try {
|
|
7440
|
-
const answer = await readline.question("Enable Computer Use? [y/N] ");
|
|
7441
|
-
return /^y(?:es)?$/i.test(answer.trim()) ? "enabled" : "disabled";
|
|
7442
|
-
} finally {
|
|
7443
|
-
readline.close();
|
|
7444
|
-
}
|
|
7445
|
-
}
|
|
7446
7424
|
try {
|
|
7447
7425
|
await main();
|
|
7448
7426
|
} catch (error) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "holycodex",
|
|
3
|
-
"version": "0.13.
|
|
3
|
+
"version": "0.13.1-dev.205.1",
|
|
4
4
|
"description": "Lean Codex-only agent toolkit installer and doctor",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agents",
|
|
@@ -39,7 +39,7 @@
|
|
|
39
39
|
"prepack": "vp run --workspace-root build"
|
|
40
40
|
},
|
|
41
41
|
"dependencies": {
|
|
42
|
-
"@holycodex/plugin": "0.13.
|
|
42
|
+
"@holycodex/plugin": "0.13.1-dev.205.1",
|
|
43
43
|
"zod": "^4.4.3"
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|