@technomoron/agent-run 0.99.24 → 0.99.26

package/dist/tools.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCodex = runCodex;
+exports.runClaude = runClaude;
+exports.getDangerArgs = getDangerArgs;
+exports.getPermissionArgs = getPermissionArgs;
+const fs = require("fs");
+const path = require("path");
+const process_1 = require("./process");
+const project_1 = require("./project");
+function runCodex(realBinary, permissionArgs, context, args, wrapperArgs) {
+    const liveDir = context.paths.liveDir;
+    const codexHomeDir = context.paths.codexHomeDir;
+    const projectRoot = context.projectRoot;
+    if (!fs.existsSync(path.join(codexHomeDir, 'AGENTS.md'))) {
+        failMissingConfig('codex', context.profileDir);
+    }
+    const realPath = process.env.AGENT_RUN_REAL_PATH ?? process.env.PATH ?? '';
+    fs.mkdirSync(codexHomeDir, { recursive: true });
+    const env = {
+        ...process.env,
+        CODEX_HOME: codexHomeDir,
+        AGENT_DIR: liveDir,
+        AGENT_PROFILE_DIR: context.profileDir,
+        AGENT_RUN_PROJECT_ROOT: projectRoot,
+        AGENT_RUN_REAL_PATH: realPath,
+        PATH: `${path.join(liveDir, 'bin')}${path.delimiter}${realPath}`
+    };
+    const runtimeArgs = wrapperArgs.sandboxMode === 'danger' ? getDangerArgs('codex') : ['-a', 'on-request', '-s', 'workspace-write'];
+    (0, process_1.execCommand)(realBinary, [
+        ...permissionArgs,
+        ...runtimeArgs,
+        '-C',
+        projectRoot,
+        ...(wrapperArgs.sandboxMode !== 'danger' && wrapperArgs.codexNetwork
+            ? ['--config', 'sandbox_workspace_write.network_access=true']
+            : []),
+        ...args
+    ], env, codexHomeDir, (code) => postflightProjectCheck(context, wrapperArgs.local, code));
+}
+function runClaude(realBinary, permissionArgs, context, args, wrapperArgs) {
+    const liveDir = context.paths.liveDir;
+    const claudePath = path.join(liveDir, 'CLAUDE.md');
+    if (!fs.existsSync(claudePath)) {
+        failMissingConfig('claude', context.profileDir);
+    }
+    const claudeConfigDir = path.join(liveDir, '.claude');
+    const realPath = process.env.AGENT_RUN_REAL_PATH ?? process.env.PATH ?? '';
+    const env = {
+        ...process.env,
+        AGENT_DIR: liveDir,
+        AGENT_PROFILE_DIR: context.profileDir,
+        AGENT_RUN_PROJECT_ROOT: context.projectRoot,
+        AGENT_RUN_REAL_PATH: realPath,
+        PATH: `${path.join(liveDir, 'bin')}${path.delimiter}${realPath}`
+    };
+    const runtimeArgs = wrapperArgs.sandboxMode === 'danger' ? getDangerArgs('claude') : permissionArgs;
+    (0, process_1.execCommand)(realBinary, [
+        ...runtimeArgs,
+        '--append-system-prompt-file',
+        claudePath,
+        '--settings',
+        path.join(claudeConfigDir, 'agent-run-settings.json'),
+        '--plugin-dir',
+        claudeConfigDir,
+        ...args
+    ], env, context.projectRoot, (code) => postflightProjectCheck(context, wrapperArgs.local, code));
+}
+function postflightProjectCheck(context, allowLocal, code) {
+    if (!context.guardrails.forbidRepoAiFiles) {
+        return code;
+    }
+    if (!allowLocal) {
+        removeClaudeLocalSettings(context.projectRoot);
+    }
+    const localAiFiles = (0, project_1.findLocalAiFiles)(context.projectRoot, context.profileDir);
+    if (localAiFiles.length === 0) {
+        return code;
+    }
+    (0, project_1.warnForLocalAiFiles)(null, context.projectRoot, localAiFiles);
+    return allowLocal ? code : 1;
+}
+function removeClaudeLocalSettings(projectRoot) {
+    const claudeDir = path.join(projectRoot, '.claude');
+    const localSettingsPath = path.join(claudeDir, 'settings.local.json');
+    if (!fs.existsSync(localSettingsPath)) {
+        return;
+    }
+    fs.rmSync(localSettingsPath);
+    try {
+        fs.rmdirSync(claudeDir);
+    }
+    catch (error) {
+        if (!isDirectoryNotEmptyError(error)) {
+            throw error;
+        }
+    }
+    process.stderr.write(`agent-run: removed Claude's project-local settings: ${localSettingsPath}\n`);
+}
+function isDirectoryNotEmptyError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOTEMPTY';
+}
+function failMissingConfig(tool, agentDir) {
+    process.stderr.write(`agent-run: no ${tool} config found for this project: ${agentDir}\n`);
+    process.stderr.write(`agent-run: run \`agent-run ${tool} --none\` to bypass agent setup, or \`agent-run ${tool} --create\` to create profile files.\n`);
+    process.exit(1);
+}
+function getDangerArgs(tool) {
+    return tool === 'codex' ? ['-a', 'never', '-s', 'danger-full-access'] : ['--dangerously-skip-permissions'];
+}
+function getPermissionArgs(tool) {
+    if (process.env.AGENT_WRAPPER_FORCE_PERMISSIVE !== '1') {
+        return [];
+    }
+    if (tool === 'claude' && typeof process.getuid === 'function' && process.getuid() !== 0) {
+        return ['--permission-mode', 'bypassPermissions'];
+    }
+    return [];
+}

package/dist/utils.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSamePathOrDescendant = isSamePathOrDescendant;
+exports.parseBooleanEnv = parseBooleanEnv;
+exports.localDateString = localDateString;
+exports.formatError = formatError;
+exports.verbose = verbose;
+exports.formatCommand = formatCommand;
+exports.fail = fail;
+exports.uniqueSorted = uniqueSorted;
+exports.formatPathList = formatPathList;
+exports.getExecutableExtensions = getExecutableExtensions;
+exports.isExecutable = isExecutable;
+exports.findExecutable = findExecutable;
+exports.isSymlink = isSymlink;
+exports.nextBackupPath = nextBackupPath;
+const fs = require("fs");
+const path = require("path");
+const constants_1 = require("./constants");
+function isSamePathOrDescendant(candidatePath, parentPath) {
+    const relative = path.relative(parentPath, candidatePath);
+    return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
+}
+function parseBooleanEnv(value) {
+    if (value === undefined) {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+function localDateString() {
+    const now = new Date();
+    const year = String(now.getFullYear()).padStart(4, '0');
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function verbose(message) {
+    if (parseBooleanEnv(process.env[constants_1.VERBOSE_ENV])) {
+        process.stderr.write(`agent-run: ${message}\n`);
+    }
+}
+function formatCommand(command, args) {
+    return [command, ...args].map(quoteArg).join(' ');
+}
+function quoteArg(value) {
+    if (value === '') {
+        return '""';
+    }
+    if (/^[A-Za-z0-9_./:=+-]+$/.test(value)) {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+function fail(message) {
+    process.stderr.write(`agent-run: ${message}\n`);
+    process.exit(1);
+}
+function uniqueSorted(values) {
+    return [...new Set(values.map((value) => path.resolve(value)))].sort((a, b) => a.localeCompare(b));
+}
+function formatPathList(paths) {
+    return paths.length === 0 ? ['  (none)'] : paths.map((entry) => `  ${entry}`);
+}
+function getExecutableExtensions(tool) {
+    if (!constants_1.IS_WINDOWS || path.extname(tool)) {
+        return [''];
+    }
+    return (process.env.PATHEXT || '.EXE;.CMD;.BAT;.COM')
+        .split(';')
+        .filter(Boolean)
+        .map((entry) => entry.toLowerCase());
+}
+function isExecutable(filePath) {
+    try {
+        if (constants_1.IS_WINDOWS) {
+            return fs.statSync(filePath).isFile();
+        }
+        fs.accessSync(filePath, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function findExecutable(command) {
+    const pathDirs = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
+    for (const dir of pathDirs) {
+        for (const extension of getExecutableExtensions(command)) {
+            const candidate = path.join(dir, `${command}${extension}`);
+            if (fs.existsSync(candidate) && isExecutable(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+function isSymlink(filePath) {
+    try {
+        return fs.lstatSync(filePath).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+function nextBackupPath(filePath) {
+    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+    let candidate = `${filePath}.bak.${timestamp}`;
+    let index = 1;
+    while (fs.existsSync(candidate) || isSymlink(candidate)) {
+        candidate = `${filePath}.bak.${timestamp}.${index}`;
+        index += 1;
+    }
+    return candidate;
+}

package/dist/walk-tree.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkTree = walkTree;
+const fs = require("fs");
+const path = require("path");
+function walkTree(dir, visitor, options = {}) {
+    if (options.shouldSkipDirectory?.(dir)) {
+        return;
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (options.shouldPrune?.(entry)) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory() && options.shouldSkipDirectory?.(fullPath)) {
+            continue;
+        }
+        const result = visitor(fullPath, entry);
+        if (entry.isDirectory() && result !== 'skip') {
+            walkTree(fullPath, visitor, options);
+        }
+    }
+}

package/examples/basic-config/README.md

@@ -7,9 +7,9 @@ It contains two pieces:
 
 - `project/`: a minimal project with `.agent-run.env` pointing at the bundled
   config root.
-- `agent-config/`: a complete config root with global templates, snippets,
-  skill templates, a personal memory skill, a profile manifest, profile-local
-  instructions, and profile overrides.
+- `agent-config/`: a complete config root with shared manifest defaults, global
+  templates, snippets, skill templates, a personal memory skill, a sparse
+  profile manifest, profile-local instructions, and profile overrides.
 
 Try it from this repository after building:
 

package/examples/basic-config/agent-config/agent-run.defaults.jsonc

@@ -0,0 +1,38 @@
+{
+  // Shared defaults; profile manifests contain only differences.
+  "kind": "code",
+  "agent": {
+    "base": "global/agents/code.md.njk",
+    "includes": [
+      "{{ profile }}/local.md.njk"
+    ]
+  },
+  "skills": {
+    "install": [
+      "commit-workflow",
+      "github-release",
+      "release-package-check",
+      "code-review-organizer"
+    ]
+  },
+  "tools": {
+    "codex": true,
+    "claude": true
+  },
+  "checks": [
+    "agent-run check .",
+    "pnpm run cleanbuild"
+  ],
+  "guardrails": {
+    "blockGitWrite": true,
+    "blockPublish": true,
+    "blockGithubRelease": true,
+    "forbidRepoAiFiles": true
+  },
+  "paths": {
+    "changesFile": "{{ projectRoot }}/CHANGES",
+    "reviewDir": "{{ profileDir }}/reviews",
+    "reviewFile": "{{ profileDir }}/reviews/REVIEW-{{ date }}.md",
+    "memoriesDir": "{{ agentDir }}/memories"
+  }
+}

package/examples/basic-config/agent-config/global/tool-templates/AGENTS.md.njk

@@ -1,6 +1,6 @@
 # Starter AGENTS for {{ profile }}
 
-Do not edit this generated file. Edit `agent-run.jsonc` and `local.md.njk`.
+Do not edit this generated file. Edit root defaults or profile-specific source files.
 
 {% for section in renderedAgentSections %}
 {{ section }}

package/examples/basic-config/agent-config/starter/basic-project/agent-run.jsonc

@@ -1,8 +1,5 @@
 {
-  "profile": "starter/basic-project",
-  "kind": "code",
   "agent": {
-    "base": "global/agents/code.md.njk",
     "includes": [
       "{{ profile }}/local.md.njk",
       "{{ profile }}/project-rules.md.njk"
@@ -20,25 +17,8 @@
       "triage": "{{ profile }}/overrides/triage.SKILL.md.njk"
     }
   },
-  "tools": {
-    "codex": true,
-    "claude": true
-  },
   "checks": [
     "agent-run check .",
-    "pnpm run cleanbuild",
     "pnpm test"
-  ],
-  "guardrails": {
-    "blockGitWrite": true,
-    "blockPublish": true,
-    "blockGithubRelease": true,
-    "forbidRepoAiFiles": true
-  },
-  "paths": {
-    "changesFile": "{{ projectRoot }}/CHANGES",
-    "reviewDir": "{{ profileDir }}/reviews",
-    "reviewFile": "{{ profileDir }}/reviews/REVIEW-{{ date }}.md",
-    "memoriesDir": "{{ agentDir }}/memories"
-  }
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@technomoron/agent-run",
-  "version": "0.99.24",
+  "version": "0.99.26",
   "packageManager": "pnpm@10.28.1",
   "bin": {
     "agent-run": "dist/agent-run.js"