old4ever/local-cal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

style: standardize formatting in opencode tooling files

Browse Source 
Reformat JSON configs and TypeScript scripts to use consistent
tab indentation, semicolons, and double quotes.
This commit is contained in:
Dmytro Stanchiev
2026-04-07 13:10:35 -04:00
parent 4e09059a3d
commit cbae9fa1c9
5 changed files with 936 additions and 879 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
.opencode/config/agent-metadata.json
View File

@@ -91,9 +91,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["content", "marketing", "writing"],
"dependencies": [
"context:standards-docs"
]
"dependencies": ["context:standards-docs"]
},
"technical-writer": {
"id": "technical-writer",
@@ -103,9 +101,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["documentation", "technical", "writing"],
"dependencies": [
"context:standards-docs"
]
"dependencies": ["context:standards-docs"]
},
"data-analyst": {
"id": "data-analyst",
@@ -125,9 +121,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["testing", "evaluation", "quality"],
"dependencies": [
"context:standards-tests"
]
"dependencies": ["context:standards-tests"]
},
"task-manager": {
"id": "task-manager",
@@ -137,9 +131,7 @@
"version": "2.0.0",
"author": "opencode",
"tags": ["task-breakdown", "planning", "coordination"],
"dependencies": [
"context:task-delegation-basics"
]
"dependencies": ["context:task-delegation-basics"]
},
"batch-executor": {
"id": "batch-executor",
@@ -149,10 +141,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["parallel-execution", "batch-management", "coordination"],
"dependencies": [
"subagent:coder-agent",
"subagent:task-manager"
]
"dependencies": ["subagent:coder-agent", "subagent:task-manager"]
},
"documentation": {
"id": "documentation",
@@ -162,9 +151,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["documentation", "writing"],
"dependencies": [
"context:standards-docs"
]
"dependencies": ["context:standards-docs"]
},
"contextscout": {
"id": "contextscout",
@@ -214,9 +201,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["coding", "implementation"],
"dependencies": [
"context:standards-code"
]
"dependencies": ["context:standards-code"]
},
"tester": {
"id": "tester",
@@ -226,9 +211,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["testing", "tdd", "quality"],
"dependencies": [
"context:standards-tests"
]
"dependencies": ["context:standards-tests"]
},
"reviewer": {
"id": "reviewer",
@@ -238,10 +221,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["review", "security", "quality"],
"dependencies": [
"context:standards-code",
"context:review-ref"
]
"dependencies": ["context:standards-code", "context:review-ref"]
},
"build-agent": {
"id": "build-agent",
@@ -261,9 +241,7 @@
"version": "1.0.0",
"author": "opencode",
"tags": ["frontend", "ui", "design"],
"dependencies": [
"context:standards-code"
]
"dependencies": ["context:standards-code"]
},
"devops-specialist": {
"id": "devops-specialist",

283
.opencode/skills/task-management/scripts/task-cli.ts
View File

@@ -19,14 +19,17 @@
* .tmp/tasks/completed/{feature-slug}/
*/
const fs = require('fs');
const path = require('path');
const fs = require("fs");
const path = require("path");
// Find project root (look for .git or package.json)
function findProjectRoot(): string {
let dir = process.cwd();
while (dir !== path.dirname(dir)) {
if (fs.existsSync(path.join(dir, '.git')) || fs.existsSync(path.join(dir, 'package.json'))) {
if (
fs.existsSync(path.join(dir, ".git")) ||
fs.existsSync(path.join(dir, "package.json"))
) {
return dir;
}
dir = path.dirname(dir);
@@ -35,13 +38,13 @@ function findProjectRoot(): string {
}
const PROJECT_ROOT = findProjectRoot();
const TASKS_DIR = path.join(PROJECT_ROOT, '.tmp', 'tasks');
const COMPLETED_DIR = path.join(TASKS_DIR, 'completed');
const TASKS_DIR = path.join(PROJECT_ROOT, ".tmp", "tasks");
const COMPLETED_DIR = path.join(TASKS_DIR, "completed");
interface Task {
id: string;
name: string;
status: 'active' | 'completed' | 'blocked' | 'archived';
status: "active" | "completed" | "blocked" | "archived";
objective: string;
context_files: string[];
reference_files?: string[];
@@ -56,7 +59,7 @@ interface Subtask {
id: string;
seq: string;
title: string;
status: 'pending' | 'in_progress' | 'completed' | 'blocked';
status: "pending" | "in_progress" | "completed" | "blocked";
depends_on: string[];
parallel: boolean;
context_files: string[];
@@ -75,34 +78,41 @@ function getFeatureDirs(): string[] {
if (!fs.existsSync(TASKS_DIR)) return [];
return fs.readdirSync(TASKS_DIR).filter((f: string) => {
const fullPath = path.join(TASKS_DIR, f);
return fs.statSync(fullPath).isDirectory() && f !== 'completed';
return fs.statSync(fullPath).isDirectory() && f !== "completed";
});
}
function loadTask(feature: string): Task | null {
const taskPath = path.join(TASKS_DIR, feature, 'task.json');
const taskPath = path.join(TASKS_DIR, feature, "task.json");
if (!fs.existsSync(taskPath)) return null;
return JSON.parse(fs.readFileSync(taskPath, 'utf-8'));
return JSON.parse(fs.readFileSync(taskPath, "utf-8"));
}
function loadSubtasks(feature: string): Subtask[] {
const featureDir = path.join(TASKS_DIR, feature);
if (!fs.existsSync(featureDir)) return [];
const files = fs.readdirSync(featureDir)
const files = fs
.readdirSync(featureDir)
.filter((f: string) => f.match(/^subtask_\d{2}\.json$/))
.sort();
return files.map((f: string) => JSON.parse(fs.readFileSync(path.join(featureDir, f), 'utf-8')));
return files.map((f: string) =>
JSON.parse(fs.readFileSync(path.join(featureDir, f), "utf-8")),
);
}
function saveSubtask(feature: string, subtask: Subtask): void {
const subtaskPath = path.join(TASKS_DIR, feature, `subtask_${subtask.seq}.json`);
const subtaskPath = path.join(
TASKS_DIR,
feature,
`subtask_${subtask.seq}.json`,
);
fs.writeFileSync(subtaskPath, JSON.stringify(subtask, null, 2));
}
function saveTask(feature: string, task: Task): void {
const taskPath = path.join(TASKS_DIR, feature, 'task.json');
const taskPath = path.join(TASKS_DIR, feature, "task.json");
fs.writeFileSync(taskPath, JSON.stringify(task, null, 2));
}
@@ -111,7 +121,7 @@ function cmdStatus(feature?: string): void {
const features = feature ? [feature] : getFeatureDirs();
if (features.length === 0) {
console.log('No active features found.');
console.log("No active features found.");
return;
}
@@ -125,40 +135,47 @@ function cmdStatus(feature?: string): void {
}
const counts = {
pending: subtasks.filter(s => s.status === 'pending').length,
in_progress: subtasks.filter(s => s.status === 'in_progress').length,
completed: subtasks.filter(s => s.status === 'completed').length,
blocked: subtasks.filter(s => s.status === 'blocked').length,
pending: subtasks.filter((s) => s.status === "pending").length,
in_progress: subtasks.filter((s) => s.status === "in_progress").length,
completed: subtasks.filter((s) => s.status === "completed").length,
blocked: subtasks.filter((s) => s.status === "blocked").length,
};
const progress = subtasks.length > 0
const progress =
subtasks.length > 0
? Math.round((counts.completed / subtasks.length) * 100)
: 0;
console.log(`\n[${f}] ${task.name}`);
console.log(` Status: ${task.status} | Progress: ${progress}% (${counts.completed}/${subtasks.length})`);
console.log(` Pending: ${counts.pending} | In Progress: ${counts.in_progress} | Completed: ${counts.completed} | Blocked: ${counts.blocked}`);
console.log(
` Status: ${task.status} | Progress: ${progress}% (${counts.completed}/${subtasks.length})`,
);
console.log(
` Pending: ${counts.pending} | In Progress: ${counts.in_progress} | Completed: ${counts.completed} | Blocked: ${counts.blocked}`,
);
}
}
function cmdNext(feature?: string): void {
const features = feature ? [feature] : getFeatureDirs();
console.log('\n=== Ready Tasks (deps satisfied) ===\n');
console.log("\n=== Ready Tasks (deps satisfied) ===\n");
for (const f of features) {
const subtasks = loadSubtasks(f);
const completedSeqs = new Set(subtasks.filter(s => s.status === 'completed').map(s => s.seq));
const completedSeqs = new Set(
subtasks.filter((s) => s.status === "completed").map((s) => s.seq),
);
const ready = subtasks.filter(s => {
if (s.status !== 'pending') return false;
return s.depends_on.every(dep => completedSeqs.has(dep));
const ready = subtasks.filter((s) => {
if (s.status !== "pending") return false;
return s.depends_on.every((dep) => completedSeqs.has(dep));
});
if (ready.length > 0) {
console.log(`[${f}]`);
for (const s of ready) {
const parallel = s.parallel ? '[parallel]' : '[sequential]';
const parallel = s.parallel ? "[parallel]" : "[sequential]";
console.log(` ${s.seq} - ${s.title} ${parallel}`);
}
console.log();
@@ -169,16 +186,18 @@ function cmdNext(feature?: string): void {
function cmdParallel(feature?: string): void {
const features = feature ? [feature] : getFeatureDirs();
console.log('\n=== Parallelizable Tasks Ready Now ===\n');
console.log("\n=== Parallelizable Tasks Ready Now ===\n");
for (const f of features) {
const subtasks = loadSubtasks(f);
const completedSeqs = new Set(subtasks.filter(s => s.status === 'completed').map(s => s.seq));
const completedSeqs = new Set(
subtasks.filter((s) => s.status === "completed").map((s) => s.seq),
);
const parallel = subtasks.filter(s => {
if (s.status !== 'pending') return false;
const parallel = subtasks.filter((s) => {
if (s.status !== "pending") return false;
if (!s.parallel) return false;
return s.depends_on.every(dep => completedSeqs.has(dep));
return s.depends_on.every((dep) => completedSeqs.has(dep));
});
if (parallel.length > 0) {
@@ -193,7 +212,7 @@ function cmdParallel(feature?: string): void {
function cmdDeps(feature: string, seq: string): void {
const subtasks = loadSubtasks(feature);
const target = subtasks.find(s => s.seq === seq);
const target = subtasks.find((s) => s.seq === seq);
if (!target) {
console.log(`Task ${seq} not found in ${feature}`);
@@ -204,22 +223,29 @@ function cmdDeps(feature: string, seq: string): void {
console.log(`${seq} - ${target.title} [${target.status}]`);
if (target.depends_on.length === 0) {
console.log(' └── (no dependencies)');
console.log(" └── (no dependencies)");
return;
}
const printDeps = (seqs: string[], indent: string = ' '): void => {
const printDeps = (seqs: string[], indent: string = " "): void => {
for (let i = 0; i < seqs.length; i++) {
const depSeq = seqs[i];
const dep = subtasks.find(s => s.seq === depSeq);
const dep = subtasks.find((s) => s.seq === depSeq);
const isLast = i === seqs.length - 1;
const branch = isLast ? '└──' : '├──';
const branch = isLast ? "└──" : "├──";
if (dep) {
const statusIcon = dep.status === 'completed' ? '✓' : dep.status === 'in_progress' ? '~' : '○';
console.log(`${indent}${branch} ${statusIcon} ${depSeq} - ${dep.title} [${dep.status}]`);
const statusIcon =
dep.status === "completed"
? "✓"
: dep.status === "in_progress"
? "~"
: "○";
console.log(
`${indent}${branch} ${statusIcon} ${depSeq} - ${dep.title} [${dep.status}]`,
);
if (dep.depends_on.length > 0) {
const newIndent = indent + (isLast ? ' ' : '│ ');
const newIndent = indent + (isLast ? " " : "│ ");
printDeps(dep.depends_on, newIndent);
}
} else {
@@ -234,25 +260,30 @@ function cmdDeps(feature: string, seq: string): void {
function cmdBlocked(feature?: string): void {
const features = feature ? [feature] : getFeatureDirs();
console.log('\n=== Blocked Tasks ===\n');
console.log("\n=== Blocked Tasks ===\n");
for (const f of features) {
const subtasks = loadSubtasks(f);
const completedSeqs = new Set(subtasks.filter(s => s.status === 'completed').map(s => s.seq));
const completedSeqs = new Set(
subtasks.filter((s) => s.status === "completed").map((s) => s.seq),
);
const blocked = subtasks.filter(s => {
if (s.status === 'blocked') return true;
if (s.status !== 'pending') return false;
return !s.depends_on.every(dep => completedSeqs.has(dep));
const blocked = subtasks.filter((s) => {
if (s.status === "blocked") return true;
if (s.status !== "pending") return false;
return !s.depends_on.every((dep) => completedSeqs.has(dep));
});
if (blocked.length > 0) {
console.log(`[${f}]`);
for (const s of blocked) {
const waitingFor = s.depends_on.filter(dep => !completedSeqs.has(dep));
const reason = s.status === 'blocked'
? 'explicitly blocked'
: `waiting: ${waitingFor.join(', ')}`;
const waitingFor = s.depends_on.filter(
(dep) => !completedSeqs.has(dep),
);
const reason =
s.status === "blocked"
? "explicitly blocked"
: `waiting: ${waitingFor.join(", ")}`;
console.log(` ${s.seq} - ${s.title} (${reason})`);
}
console.log();
@@ -262,19 +293,19 @@ function cmdBlocked(feature?: string): void {
function cmdComplete(feature: string, seq: string, summary: string): void {
if (summary.length > 200) {
console.log('Error: Summary must be max 200 characters');
console.log("Error: Summary must be max 200 characters");
process.exit(1);
}
const subtasks = loadSubtasks(feature);
const subtask = subtasks.find(s => s.seq === seq);
const subtask = subtasks.find((s) => s.seq === seq);
if (!subtask) {
console.log(`Task ${seq} not found in ${feature}`);
process.exit(1);
}
subtask.status = 'completed';
subtask.status = "completed";
subtask.completed_at = new Date().toISOString();
subtask.completion_summary = summary;
@@ -284,7 +315,9 @@ function cmdComplete(feature: string, seq: string, summary: string): void {
const task = loadTask(feature);
if (task) {
const newSubtasks = loadSubtasks(feature);
task.completed_count = newSubtasks.filter(s => s.status === 'completed').length;
task.completed_count = newSubtasks.filter(
(s) => s.status === "completed",
).length;
saveTask(feature, task);
}
@@ -300,42 +333,54 @@ function cmdValidate(feature?: string): void {
const features = feature ? [feature] : getFeatureDirs();
let hasErrors = false;
const validTaskStatuses = new Set(['active', 'completed', 'blocked', 'archived']);
const validSubtaskStatuses = new Set(['pending', 'in_progress', 'completed', 'blocked']);
const validTaskStatuses = new Set([
"active",
"completed",
"blocked",
"archived",
]);
const validSubtaskStatuses = new Set([
"pending",
"in_progress",
"completed",
"blocked",
]);
const requiredTaskFields = [
'id',
'name',
'status',
'objective',
'context_files',
'exit_criteria',
'subtask_count',
'completed_count',
'created_at',
'completed_at',
"id",
"name",
"status",
"objective",
"context_files",
"exit_criteria",
"subtask_count",
"completed_count",
"created_at",
"completed_at",
];
const requiredSubtaskFields = [
'id',
'seq',
'title',
'status',
'depends_on',
'parallel',
'context_files',
'acceptance_criteria',
'deliverables',
'agent_id',
'started_at',
'completed_at',
'completion_summary',
"id",
"seq",
"title",
"status",
"depends_on",
"parallel",
"context_files",
"acceptance_criteria",
"deliverables",
"agent_id",
"started_at",
"completed_at",
"completion_summary",
];
const hasField = (obj: any, field: string): boolean => Object.prototype.hasOwnProperty.call(obj, field);
const isStringArray = (value: any): boolean => Array.isArray(value) && value.every(v => typeof v === 'string');
const hasField = (obj: any, field: string): boolean =>
Object.prototype.hasOwnProperty.call(obj, field);
const isStringArray = (value: any): boolean =>
Array.isArray(value) && value.every((v) => typeof v === "string");
console.log('\n=== Validation Results ===\n');
console.log("\n=== Validation Results ===\n");
for (const f of features) {
const errors: string[] = [];
@@ -343,17 +388,17 @@ function cmdValidate(feature?: string): void {
// Check task.json exists
const task = loadTask(f);
if (!task) {
errors.push('Missing task.json');
errors.push("Missing task.json");
}
// Load and validate subtasks
const subtasks = loadSubtasks(f);
const seqCounts = new Map<string, number>();
for (const s of subtasks) {
const seq = typeof s.seq === 'string' ? s.seq : '';
const seq = typeof s.seq === "string" ? s.seq : "";
seqCounts.set(seq, (seqCounts.get(seq) || 0) + 1);
}
const seqs = new Set(subtasks.map(s => s.seq));
const seqs = new Set(subtasks.map((s) => s.seq));
if (task) {
// Required fields in task.json
@@ -365,7 +410,9 @@ function cmdValidate(feature?: string): void {
// Task ID should match feature slug
if (task.id !== f) {
errors.push(`task.json id ('${task.id}') should match feature slug ('${f}')`);
errors.push(
`task.json id ('${task.id}') should match feature slug ('${f}')`,
);
}
// Task status should be valid
@@ -375,19 +422,23 @@ function cmdValidate(feature?: string): void {
// Basic type checks for key task fields
if (!isStringArray(task.context_files)) {
errors.push('task.json: context_files must be string[]');
errors.push("task.json: context_files must be string[]");
}
if (hasField(task, 'reference_files') && task.reference_files !== undefined && !isStringArray(task.reference_files)) {
errors.push('task.json: reference_files must be string[] when present');
if (
hasField(task, "reference_files") &&
task.reference_files !== undefined &&
!isStringArray(task.reference_files)
) {
errors.push("task.json: reference_files must be string[] when present");
}
if (!isStringArray(task.exit_criteria)) {
errors.push('task.json: exit_criteria must be string[]');
errors.push("task.json: exit_criteria must be string[]");
}
if (typeof task.subtask_count !== 'number') {
errors.push('task.json: subtask_count must be number');
if (typeof task.subtask_count !== "number") {
errors.push("task.json: subtask_count must be number");
}
if (typeof task.completed_count !== 'number') {
errors.push('task.json: completed_count must be number');
if (typeof task.completed_count !== "number") {
errors.push("task.json: completed_count must be number");
}
}
@@ -395,7 +446,7 @@ function cmdValidate(feature?: string): void {
// Required fields in subtask files
for (const field of requiredSubtaskFields) {
if (!hasField(s, field)) {
errors.push(`${s.seq || '??'}: missing required field '${field}'`);
errors.push(`${s.seq || "??"}: missing required field '${field}'`);
}
}
@@ -421,13 +472,17 @@ function cmdValidate(feature?: string): void {
if (!isStringArray(s.depends_on)) {
errors.push(`${s.seq}: depends_on must be string[]`);
}
if (typeof s.parallel !== 'boolean') {
if (typeof s.parallel !== "boolean") {
errors.push(`${s.seq}: parallel must be boolean`);
}
if (!isStringArray(s.context_files)) {
errors.push(`${s.seq}: context_files must be string[]`);
}
if (hasField(s, 'reference_files') && s.reference_files !== undefined && !isStringArray(s.reference_files)) {
if (
hasField(s, "reference_files") &&
s.reference_files !== undefined &&
!isStringArray(s.reference_files)
) {
errors.push(`${s.seq}: reference_files must be string[] when present`);
}
if (!isStringArray(s.acceptance_criteria)) {
@@ -447,7 +502,7 @@ function cmdValidate(feature?: string): void {
}
// Check for missing dependencies
for (const dep of (Array.isArray(s.depends_on) ? s.depends_on : [])) {
for (const dep of Array.isArray(s.depends_on) ? s.depends_on : []) {
if (!seqs.has(dep)) {
errors.push(`${s.seq}: depends on non-existent task ${dep}`);
}
@@ -457,13 +512,15 @@ function cmdValidate(feature?: string): void {
const visited = new Set<string>();
const checkCircular = (seq: string, path: string[]): boolean => {
if (path.includes(seq)) {
errors.push(`${s.seq}: circular dependency detected: ${[...path, seq].join(' -> ')}`);
errors.push(
`${s.seq}: circular dependency detected: ${[...path, seq].join(" -> ")}`,
);
return true;
}
if (visited.has(seq)) return false;
visited.add(seq);
const task = subtasks.find(t => t.seq === seq);
const task = subtasks.find((t) => t.seq === seq);
if (task) {
for (const dep of task.depends_on) {
if (checkCircular(dep, [...path, seq])) return true;
@@ -476,13 +533,15 @@ function cmdValidate(feature?: string): void {
// Check counts match
if (task && task.subtask_count !== subtasks.length) {
errors.push(`task.json subtask_count (${task.subtask_count}) doesn't match actual count (${subtasks.length})`);
errors.push(
`task.json subtask_count (${task.subtask_count}) doesn't match actual count (${subtasks.length})`,
);
}
// Print results
console.log(`[${f}]`);
if (errors.length === 0) {
console.log(' ✓ All checks passed');
console.log(" ✓ All checks passed");
} else {
for (const e of errors) {
console.log(` ✗ ERROR: ${e}`);
@@ -499,33 +558,33 @@ function cmdValidate(feature?: string): void {
const [, , command, ...args] = process.argv;
switch (command) {
case 'status':
case "status":
cmdStatus(args[0]);
break;
case 'next':
case "next":
cmdNext(args[0]);
break;
case 'parallel':
case "parallel":
cmdParallel(args[0]);
break;
case 'deps':
case "deps":
if (args.length < 2) {
console.log('Usage: deps <feature> <seq>');
console.log("Usage: deps <feature> <seq>");
process.exit(1);
}
cmdDeps(args[0], args[1]);
break;
case 'blocked':
case "blocked":
cmdBlocked(args[0]);
break;
case 'complete':
case "complete":
if (args.length < 3) {
console.log('Usage: complete <feature> <seq> "summary"');
process.exit(1);
}
cmdComplete(args[0], args[1], args.slice(2).join(' '));
cmdComplete(args[0], args[1], args.slice(2).join(" "));
break;
case 'validate':
case "validate":
cmdValidate(args[0]);
break;
default:

118
.opencode/tool/env/index.ts vendored
View File

@@ -1,28 +1,28 @@
import { readFile } from "fs/promises"
import { resolve } from "path"
import { readFile } from "fs/promises";
import { resolve } from "path";
/**
* Configuration for environment variable loading
*/
export interface EnvLoaderConfig {
/** Custom paths to search for .env files (relative to current working directory) */
searchPaths?: string[]
searchPaths?: string[];
/** Whether to log when environment variables are loaded */
verbose?: boolean
verbose?: boolean;
/** Whether to override existing environment variables */
override?: boolean
override?: boolean;
}
/**
* Default search paths for .env files
*/
const DEFAULT_ENV_PATHS = [
'./.env',
'../.env',
'../../.env',
'../plugin/.env',
'../../../.env'
]
"./.env",
"../.env",
"../../.env",
"../plugin/.env",
"../../../.env",
];
/**
* Load environment variables from .env files
@@ -31,41 +31,43 @@ const DEFAULT_ENV_PATHS = [
* @param config Configuration options
* @returns Object containing loaded environment variables
*/
export async function loadEnvVariables(config: EnvLoaderConfig = {}): Promise<Record<string, string>> {
export async function loadEnvVariables(
config: EnvLoaderConfig = {},
): Promise<Record<string, string>> {
const {
searchPaths = DEFAULT_ENV_PATHS,
verbose = false,
override = false
} = config
override = false,
} = config;
const loadedVars: Record<string, string> = {}
const loadedVars: Record<string, string> = {};
for (const envPath of searchPaths) {
try {
const fullPath = resolve(envPath)
const content = await readFile(fullPath, 'utf8')
const fullPath = resolve(envPath);
const content = await readFile(fullPath, "utf8");
if (verbose) {
console.log(`Checking .env file: ${envPath}`)
console.log(`Checking .env file: ${envPath}`);
}
// Parse .env file content
const lines = content.split('\n')
const lines = content.split("\n");
for (const line of lines) {
const trimmed = line.trim()
if (trimmed && !trimmed.startsWith('#') && trimmed.includes('=')) {
const [key, ...valueParts] = trimmed.split('=')
const value = valueParts.join('=').trim()
const trimmed = line.trim();
if (trimmed && !trimmed.startsWith("#") && trimmed.includes("=")) {
const [key, ...valueParts] = trimmed.split("=");
const value = valueParts.join("=").trim();
// Remove quotes if present
const cleanValue = value.replace(/^["']|["']$/g, '')
const cleanValue = value.replace(/^["']|["']$/g, "");
if (key && cleanValue && (override || !process.env[key])) {
process.env[key] = cleanValue
loadedVars[key] = cleanValue
process.env[key] = cleanValue;
loadedVars[key] = cleanValue;
if (verbose) {
console.log(`Loaded ${key} from ${envPath}`)
console.log(`Loaded ${key} from ${envPath}`);
}
}
}
@@ -73,12 +75,12 @@ export async function loadEnvVariables(config: EnvLoaderConfig = {}): Promise<Re
} catch (error) {
// File doesn't exist or can't be read, continue to next
if (verbose) {
console.log(`Could not read ${envPath}: ${error.message}`)
console.log(`Could not read ${envPath}: ${error.message}`);
}
}
}
return loadedVars
return loadedVars;
}
/**
@@ -88,17 +90,20 @@ export async function loadEnvVariables(config: EnvLoaderConfig = {}): Promise<Re
* @param config Configuration options
* @returns The environment variable value or null if not found
*/
export async function getEnvVariable(varName: string, config: EnvLoaderConfig = {}): Promise<string | null> {
export async function getEnvVariable(
varName: string,
config: EnvLoaderConfig = {},
): Promise<string | null> {
// First check if it's already in the environment
let value = process.env[varName]
let value = process.env[varName];
if (!value) {
// Try to load from .env files
const loadedVars = await loadEnvVariables(config)
value = loadedVars[varName] || process.env[varName]
const loadedVars = await loadEnvVariables(config);
value = loadedVars[varName] || process.env[varName];
}
return value || null
return value || null;
}
/**
@@ -110,11 +115,14 @@ export async function getEnvVariable(varName: string, config: EnvLoaderConfig =
* @returns The environment variable value
* @throws Error if the variable is not found
*/
export async function getRequiredEnvVariable(varName: string, config: EnvLoaderConfig = {}): Promise<string> {
const value = await getEnvVariable(varName, config)
export async function getRequiredEnvVariable(
varName: string,
config: EnvLoaderConfig = {},
): Promise<string> {
const value = await getEnvVariable(varName, config);
if (!value) {
const searchPaths = config.searchPaths || DEFAULT_ENV_PATHS
const searchPaths = config.searchPaths || DEFAULT_ENV_PATHS;
throw new Error(`${varName} not found. Please set it in your environment or .env file.
To fix this:
@@ -122,11 +130,15 @@ To fix this:
2. Or export it: export ${varName}=your_value_here
Current working directory: ${process.cwd()}
Searched paths: ${searchPaths.join(', ')}
Environment variables available: ${Object.keys(process.env).filter(k => k.includes(varName.split('_')[0])).join(', ') || 'none matching'}`)
Searched paths: ${searchPaths.join(", ")}
Environment variables available: ${
Object.keys(process.env)
.filter((k) => k.includes(varName.split("_")[0]))
.join(", ") || "none matching"
}`);
}
return value
return value;
}
/**
@@ -137,22 +149,27 @@ Environment variables available: ${Object.keys(process.env).filter(k => k.includ
* @returns Object with variable names as keys and values as values
* @throws Error if any variable is not found
*/
export async function getRequiredEnvVariables(varNames: string[], config: EnvLoaderConfig = {}): Promise<Record<string, string>> {
const result: Record<string, string> = {}
export async function getRequiredEnvVariables(
varNames: string[],
config: EnvLoaderConfig = {},
): Promise<Record<string, string>> {
const result: Record<string, string> = {};
// Load all .env files first
await loadEnvVariables(config)
await loadEnvVariables(config);
// Check each required variable
for (const varName of varNames) {
const value = process.env[varName]
const value = process.env[varName];
if (!value) {
throw new Error(`Required environment variable ${varName} not found. Please set it in your environment or .env file.`)
throw new Error(
`Required environment variable ${varName} not found. Please set it in your environment or .env file.`,
);
}
result[varName] = value
result[varName] = value;
}
return result
return result;
}
/**
@@ -163,6 +180,9 @@ export async function getRequiredEnvVariables(varNames: string[], config: EnvLoa
* @returns The API key value
* @throws Error if the API key is not found
*/
export async function getApiKey(apiKeyName: string, config: EnvLoaderConfig = {}): Promise<string> {
return getRequiredEnvVariable(apiKeyName, config)
export async function getApiKey(
apiKeyName: string,
config: EnvLoaderConfig = {},
): Promise<string> {
return getRequiredEnvVariable(apiKeyName, config);
}