import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";

import { homedir } from "node:os";

import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";

export {

parseCommandArgs,

substituteArgs,

} from "../../../packages/agent-core/src/harness/prompt-template-arguments.js";

import {

parseCommandArgs,

substituteArgs,

} from "../../../packages/agent-core/src/harness/prompt-template-arguments.js";

import { CONFIG_DIR_NAME } from "../config.js";

import { parseFrontmatter } from "../utils/frontmatter.js";

import { createSyntheticSourceInfo, type SourceInfo } from "./source-info.js";

filePath: string; // Absolute path to the template file

}

/**

* Parse command arguments respecting quoted strings (bash-style)

* Returns array of arguments

*/

export function parseCommandArgs(argsString: string): string[] {

const args: string[] = [];

let current = "";

let inQuote: string | null = null;

for (let i = 0; i < argsString.length; i++) {

const char = argsString[i];

if (inQuote) {

if (char === inQuote) {

inQuote = null;

} else {

current += char;

}

} else if (char === '"' || char === "'") {

inQuote = char;

} else if (/\s/.test(char)) {

if (current) {

args.push(current);

current = "";

}

} else {

current += char;

}

}

if (current) {

args.push(current);

}

return args;

}

function parseSafeNonNegativeInteger(raw: string): number | undefined {

const parsed = Number(raw);

return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : undefined;

}

/**

* Substitute argument placeholders in template content

* Supports:

* - $1, $2, ... for positional args

* - $@ and $ARGUMENTS for all args

* - ${@:N} for args from Nth onwards (bash-style slicing)

* - ${@:N:L} for L args starting from Nth

*

* Note: Replacement happens on the template string only. Argument values

* containing patterns like $1, $@, or $ARGUMENTS are NOT recursively substituted.

*/

export function substituteArgs(content: string, args: string[]): string {

let result = content;

// Replace $1, $2, etc. with positional args FIRST (before wildcards)

// This prevents wildcard replacement values containing $<digit> patterns from being re-substituted

result = result.replace(/\$(\d+)/g, (_, num) => {

const parsed = parseSafeNonNegativeInteger(num);

if (parsed === undefined || parsed <= 0) {

return "";

}

const index = parsed - 1;

return args[index] ?? "";

});

// Replace ${@:start} or ${@:start:length} with sliced args (bash-style)

// Process BEFORE simple $@ to avoid conflicts

result = result.replace(/\$\{@:(\d+)(?::(\d+))?\}/g, (_, startStr, lengthStr) => {

const parsedStart = parseSafeNonNegativeInteger(startStr);

if (parsedStart === undefined) {

return "";

}

let start = parsedStart - 1; // Convert to 0-indexed (user provides 1-indexed)

// Treat 0 as 1 (bash convention: args start at 1)

if (start < 0) {

start = 0;

}

if (lengthStr) {

const length = parseSafeNonNegativeInteger(lengthStr);

if (length === undefined) {

return "";

}

return args.slice(start, start + length).join(" ");

}

return args.slice(start).join(" ");

});

// Pre-compute all args joined (optimization)

const allArgs = args.join(" ");

// Replace $ARGUMENTS with all args joined (new syntax, aligns with Claude, Codex, OpenCode)

result = result.replace(/\$ARGUMENTS/g, allArgs);

// Replace $@ with all args joined (existing syntax)

result = result.replace(/\$@/g, allArgs);

return result;

}

function loadTemplateFromFile(filePath: string, sourceInfo: SourceInfo): PromptTemplate | null {

try {

const rawContent = readFileSync(filePath, "utf-8");