feat(cli): Bun-first CLI migration with 7 commands and comprehensive test suite (#259)
* feat(cli): migrate packages/cli to Bun-first with full test suite
- Replace fs-extra with Bun.file/Bun.write/node:fs/promises across all 9 source files
- Fix --help fast-path so all 8 subcommands are visible
- Replace tsup/tsx/vitest with bun build/bun run/bun:test
- Replace __dirname with import.meta.dir; use JSON import assertion for version
- Fix hardcoded OAC_VERSION in add.ts; add hashesMatch import to status.ts
- Replace computeFileHash with Bun.file().bytes() in sha256.ts
- Rename checkNodeVersion → checkBunVersion; parallelise doctor checks
- Fix TypeScript void-inference errors in update.ts, list.ts, status.ts
by replacing .catch() with let/try-catch where result is used downstream
- Add ManifestError named error class; remove unsafe type casts
- Add 43 bun:test unit tests (sha256, manifest, installer, version) — 0 failures
* fix(cli): resolve critical bugs and standards violations found in review
Critical bug fixes:
- ide-detect.ts: replace Bun.file(dir).exists() with stat().isDirectory()
for all directory checks — Bun.file().exists() always returns false for
directories, breaking Cursor/Windsurf/OpenCode/Claude detection entirely
- bundled.ts: add registry.json exclusion anchor to findPackageRoot() to
prevent monorepo root from matching before the CLI package root
Standards cleanup (§4.1, §5.1, §6.1, §15.3, §21.1):
- status.ts: parallelise findModifiedFiles + detectIdes with Promise.all
- apply.ts: fix duplicate warn/limit messages; remove else after return in
reportWarnings; remove redundant mkdir before Bun.write
- version.ts: remove unnecessary (pkgJson as {version?:string}) cast
- manifest.ts: remove redundant mkdir before Bun.write; remove as unknown cast
- installer.ts: remove redundant mkdir calls before Bun.write throughout
- add.ts: add comment explaining why node:fs/promises rm is used
Tests (43 → 142, +99 new tests across 4 new files):
- ide-detect.test.ts: 26 tests covering all 4 IDEs, both claude indicators,
detectIdes parallel, isIdePresent — directly validates the directory fix
- bundled.test.ts: 27 tests for classifyBundledFile, findPackageRoot,
listBundledFiles, getBundledFilePath, bundledFileExists
- config.test.ts: 25 tests for readConfig/writeConfig round-trips,
createDefaultConfig, mergeConfig, isYoloMode, isAutoBackup
- installer-update.test.ts: 14 tests covering all 5 updateFiles decision
branches (install/update/skip/yolo/dry-run) plus isProjectRoot
- sha256.test.ts: +4 tests for empty file, large file, binary content
* fix(cli): fix P0 bugs — global flags, .git detection, package root resolution
- Remove duplicate --dry-run/--yolo/--verbose from parent program; Commander.js
global option stealing caused all safety flags to be silently dropped in every
subcommand action callback
- Fix isProjectRoot() to use stat() for .git detection; Bun.file().exists()
returns false for directories, breaking oac init in standard git repos
- Add OAC_PACKAGE_ROOT env var override to getPackageRoot() for dev/monorepo mode;
registry.json heuristic excluded the repo root causing oac init/add/update to
throw when run from source
- Fix build script: remove --banner flag that caused double shebang in dist/index.js
- Rewrite bin/oac.js to invoke bun instead of node (dist is bun-only target)
- Refactor installer.ts let accumulators to const using Promise.all + reduce
- Add MVP planning docs (00-MVP-PLAN.md, master synthesis, project breakdown)
* fix(install.sh): handle both singular and plural component type formats
The get_registry_key() function was always adding 's' to the type,
causing 'contexts' to become 'contextss' which doesn't exist in registry.json.
Now handles:
- Singular forms: context → contexts, agent → agents, skill → skills
- Plural forms: contexts → contexts (unchanged), agents → agents
- Config stays singular
- Fallback for any type ending in 's'
Fixes #257
This commit is contained in:
Darren Hinde
GitHub
parent
40dd267b12
commit
d2a633d7dc
38 changed files with 15033 additions and 2085 deletions
93
bin/oac.js
93
bin/oac.js
|
|
@ -1,90 +1,23 @@
|
|||
#!/usr/bin/env node
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* OpenAgents Control (OAC) CLI
|
||||
*
|
||||
* This is the main entry point for the @openagents/control package.
|
||||
* It runs the install.sh script to set up the OpenAgents Control system.
|
||||
*/
|
||||
|
||||
const { spawn } = require('child_process');
|
||||
const { execFileSync } = require('child_process');
|
||||
const path = require('path');
|
||||
const fs = require('fs');
|
||||
|
||||
// Get the package root directory
|
||||
const packageRoot = path.join(__dirname, '..');
|
||||
const cliDist = path.join(__dirname, '..', 'packages', 'cli', 'dist', 'index.js');
|
||||
|
||||
// Path to install.sh
|
||||
const installScript = path.join(packageRoot, 'install.sh');
|
||||
|
||||
// Check if install.sh exists
|
||||
if (!fs.existsSync(installScript)) {
|
||||
console.error('Error: install.sh not found at', installScript);
|
||||
if (!fs.existsSync(cliDist)) {
|
||||
console.error('Error: OAC CLI not built yet. Run: npm run build -w packages/cli');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Get command line arguments (skip node and script path)
|
||||
const args = process.argv.slice(2);
|
||||
|
||||
// If no arguments provided, show help
|
||||
if (args.length === 0) {
|
||||
console.log(`
|
||||
╔═══════════════════════════════════════════════════════════════╗
|
||||
║ OpenAgents Control (OAC) ║
|
||||
║ AI agent framework for plan-first development workflows ║
|
||||
╚═══════════════════════════════════════════════════════════════╝
|
||||
|
||||
Usage:
|
||||
oac [profile] Install with a specific profile
|
||||
oac --help Show this help message
|
||||
oac --version Show version information
|
||||
|
||||
Available Profiles:
|
||||
essential Minimal setup (OpenAgent only)
|
||||
developer Full development setup (recommended)
|
||||
business Business-focused agents
|
||||
advanced Advanced features and specialists
|
||||
full Everything included
|
||||
|
||||
Examples:
|
||||
oac Interactive installation
|
||||
oac developer Install with developer profile
|
||||
oac --help Show detailed help
|
||||
|
||||
For more information, visit:
|
||||
https://github.com/darrenhinde/OpenAgentsControl
|
||||
`);
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// Handle --version flag
|
||||
if (args.includes('--version') || args.includes('-v')) {
|
||||
const packageJson = require(path.join(packageRoot, 'package.json'));
|
||||
console.log(`@openagents/control v${packageJson.version}`);
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// Handle --help flag
|
||||
if (args.includes('--help') || args.includes('-h')) {
|
||||
// Run install.sh with --help
|
||||
args.push('--help');
|
||||
}
|
||||
|
||||
// Run the install script with bash
|
||||
const child = spawn('bash', [installScript, ...args], {
|
||||
cwd: packageRoot,
|
||||
stdio: 'inherit',
|
||||
env: {
|
||||
...process.env,
|
||||
OAC_PACKAGE_ROOT: packageRoot
|
||||
try {
|
||||
execFileSync('bun', [cliDist, ...process.argv.slice(2)], { stdio: 'inherit' });
|
||||
} catch (err) {
|
||||
if (err.code === 'ENOENT') {
|
||||
console.error('Error: Bun is required to run OAC CLI. Install from https://bun.sh');
|
||||
process.exit(1);
|
||||
}
|
||||
});
|
||||
|
||||
child.on('error', (error) => {
|
||||
console.error('Error running install script:', error.message);
|
||||
process.exit(1);
|
||||
});
|
||||
|
||||
child.on('exit', (code) => {
|
||||
process.exit(code || 0);
|
||||
});
|
||||
process.exitCode = err.status ?? 1;
|
||||
}
|
||||
|
|
|
|||
223
bun.lock
223
bun.lock
|
|
@ -1,5 +1,6 @@
|
|||
{
|
||||
"lockfileVersion": 1,
|
||||
"configVersion": 0,
|
||||
"workspaces": {
|
||||
"": {
|
||||
"name": "opencode-agents",
|
||||
|
|
@ -27,8 +28,66 @@
|
|||
"vitest": "^1.6.1",
|
||||
},
|
||||
},
|
||||
"packages/cli": {
|
||||
"name": "@nextsystems/oac-cli",
|
||||
"version": "1.0.0",
|
||||
"bin": {
|
||||
"oac": "./dist/index.js",
|
||||
},
|
||||
"dependencies": {
|
||||
"@openagents-control/compatibility-layer": "*",
|
||||
"chalk": "^5.3.0",
|
||||
"commander": "^12.0.0",
|
||||
"ora": "^8.0.0",
|
||||
"semver": "^7.6.0",
|
||||
"zod": "^3.23.0",
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/bun": "latest",
|
||||
"@types/node": "^20.0.0",
|
||||
"@types/semver": "^7.5.0",
|
||||
"typescript": "^5.4.0",
|
||||
},
|
||||
},
|
||||
"packages/compatibility-layer": {
|
||||
"name": "@openagents-control/compatibility-layer",
|
||||
"version": "0.1.0",
|
||||
"bin": {
|
||||
"oac-compat": "dist/cli/index.js",
|
||||
},
|
||||
"dependencies": {
|
||||
"chalk": "^5.3.0",
|
||||
"commander": "^12.1.0",
|
||||
"gray-matter": "^4.0.3",
|
||||
"js-yaml": "^4.1.0",
|
||||
"ora": "^8.0.1",
|
||||
"zod": "^3.23.8",
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/js-yaml": "^4.0.9",
|
||||
"@types/node": "^20.12.12",
|
||||
"@typescript-eslint/eslint-plugin": "^7.10.0",
|
||||
"@typescript-eslint/parser": "^7.10.0",
|
||||
"@vitest/coverage-v8": "^1.6.0",
|
||||
"eslint": "^8.57.0",
|
||||
"typescript": "^5.4.5",
|
||||
"vitest": "^1.6.0",
|
||||
},
|
||||
},
|
||||
},
|
||||
"packages": {
|
||||
"@ampproject/remapping": ["@ampproject/remapping@2.3.0", "", { "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw=="],
|
||||
|
||||
"@babel/helper-string-parser": ["@babel/helper-string-parser@7.27.1", "", {}, "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA=="],
|
||||
|
||||
"@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.28.5", "", {}, "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q=="],
|
||||
|
||||
"@babel/parser": ["@babel/parser@7.29.0", "", { "dependencies": { "@babel/types": "^7.29.0" }, "bin": "./bin/babel-parser.js" }, "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww=="],
|
||||
|
||||
"@babel/types": ["@babel/types@7.29.0", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A=="],
|
||||
|
||||
"@bcoe/v8-coverage": ["@bcoe/v8-coverage@0.2.3", "", {}, "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw=="],
|
||||
|
||||
"@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.25.12", "", { "os": "aix", "cpu": "ppc64" }, "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA=="],
|
||||
|
||||
"@esbuild/android-arm": ["@esbuild/android-arm@0.25.12", "", { "os": "android", "cpu": "arm" }, "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg=="],
|
||||
|
|
@ -99,16 +158,28 @@
|
|||
|
||||
"@isaacs/brace-expansion": ["@isaacs/brace-expansion@5.0.0", "", { "dependencies": { "@isaacs/balanced-match": "^4.0.1" } }, ""],
|
||||
|
||||
"@istanbuljs/schema": ["@istanbuljs/schema@0.1.3", "", {}, "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA=="],
|
||||
|
||||
"@jest/schemas": ["@jest/schemas@29.6.3", "", { "dependencies": { "@sinclair/typebox": "^0.27.8" } }, "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA=="],
|
||||
|
||||
"@jridgewell/gen-mapping": ["@jridgewell/gen-mapping@0.3.13", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.0", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA=="],
|
||||
|
||||
"@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.2", "", {}, "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw=="],
|
||||
|
||||
"@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
|
||||
|
||||
"@jridgewell/trace-mapping": ["@jridgewell/trace-mapping@0.3.31", "", { "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" } }, "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw=="],
|
||||
|
||||
"@nextsystems/oac-cli": ["@nextsystems/oac-cli@workspace:packages/cli"],
|
||||
|
||||
"@nodelib/fs.scandir": ["@nodelib/fs.scandir@2.1.5", "", { "dependencies": { "@nodelib/fs.stat": "2.0.5", "run-parallel": "^1.1.9" } }, ""],
|
||||
|
||||
"@nodelib/fs.stat": ["@nodelib/fs.stat@2.0.5", "", {}, ""],
|
||||
|
||||
"@nodelib/fs.walk": ["@nodelib/fs.walk@1.2.8", "", { "dependencies": { "@nodelib/fs.scandir": "2.1.5", "fastq": "^1.6.0" } }, ""],
|
||||
|
||||
"@openagents-control/compatibility-layer": ["@openagents-control/compatibility-layer@workspace:packages/compatibility-layer"],
|
||||
|
||||
"@opencode-agents/eval-framework": ["@opencode-agents/eval-framework@workspace:evals/framework"],
|
||||
|
||||
"@opencode-ai/sdk": ["@opencode-ai/sdk@1.0.90", "", {}, ""],
|
||||
|
|
@ -159,10 +230,14 @@
|
|||
|
||||
"@sinclair/typebox": ["@sinclair/typebox@0.27.8", "", {}, "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA=="],
|
||||
|
||||
"@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
|
||||
|
||||
"@types/estree": ["@types/estree@1.0.8", "", {}, "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w=="],
|
||||
|
||||
"@types/glob": ["@types/glob@8.1.0", "", { "dependencies": { "@types/minimatch": "^5.1.2", "@types/node": "*" } }, ""],
|
||||
|
||||
"@types/js-yaml": ["@types/js-yaml@4.0.9", "", {}, "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg=="],
|
||||
|
||||
"@types/json-schema": ["@types/json-schema@7.0.15", "", {}, ""],
|
||||
|
||||
"@types/minimatch": ["@types/minimatch@5.1.2", "", {}, ""],
|
||||
|
|
@ -171,24 +246,26 @@
|
|||
|
||||
"@types/semver": ["@types/semver@7.7.1", "", {}, ""],
|
||||
|
||||
"@typescript-eslint/eslint-plugin": ["@typescript-eslint/eslint-plugin@6.21.0", "", { "dependencies": { "@eslint-community/regexpp": "^4.5.1", "@typescript-eslint/scope-manager": "6.21.0", "@typescript-eslint/type-utils": "6.21.0", "@typescript-eslint/utils": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4", "graphemer": "^1.4.0", "ignore": "^5.2.4", "natural-compare": "^1.4.0", "semver": "^7.5.4", "ts-api-utils": "^1.0.1" }, "peerDependencies": { "@typescript-eslint/parser": "^6.0.0 || ^6.0.0-alpha", "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
"@typescript-eslint/eslint-plugin": ["@typescript-eslint/eslint-plugin@7.18.0", "", { "dependencies": { "@eslint-community/regexpp": "^4.10.0", "@typescript-eslint/scope-manager": "7.18.0", "@typescript-eslint/type-utils": "7.18.0", "@typescript-eslint/utils": "7.18.0", "@typescript-eslint/visitor-keys": "7.18.0", "graphemer": "^1.4.0", "ignore": "^5.3.1", "natural-compare": "^1.4.0", "ts-api-utils": "^1.3.0" }, "peerDependencies": { "@typescript-eslint/parser": "^7.0.0", "eslint": "^8.56.0" } }, "sha512-94EQTWZ40mzBc42ATNIBimBEDltSJ9RQHCC8vc/PDbxi4k8dVwUAv4o98dk50M1zB+JGFxp43FP7f8+FP8R6Sw=="],
|
||||
|
||||
"@typescript-eslint/parser": ["@typescript-eslint/parser@6.21.0", "", { "dependencies": { "@typescript-eslint/scope-manager": "6.21.0", "@typescript-eslint/types": "6.21.0", "@typescript-eslint/typescript-estree": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4" }, "peerDependencies": { "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
"@typescript-eslint/parser": ["@typescript-eslint/parser@7.18.0", "", { "dependencies": { "@typescript-eslint/scope-manager": "7.18.0", "@typescript-eslint/types": "7.18.0", "@typescript-eslint/typescript-estree": "7.18.0", "@typescript-eslint/visitor-keys": "7.18.0", "debug": "^4.3.4" }, "peerDependencies": { "eslint": "^8.56.0" } }, "sha512-4Z+L8I2OqhZV8qA132M4wNL30ypZGYOQVBfMgxDH/K5UX0PNqTu1c6za9ST5r9+tavvHiTWmBnKzpCJ/GlVFtg=="],
|
||||
|
||||
"@typescript-eslint/scope-manager": ["@typescript-eslint/scope-manager@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0" } }, ""],
|
||||
"@typescript-eslint/scope-manager": ["@typescript-eslint/scope-manager@7.18.0", "", { "dependencies": { "@typescript-eslint/types": "7.18.0", "@typescript-eslint/visitor-keys": "7.18.0" } }, "sha512-jjhdIE/FPF2B7Z1uzc6i3oWKbGcHb87Qw7AWj6jmEqNOfDFbJWtjt/XfwCpvNkpGWlcJaog5vTR+VV8+w9JflA=="],
|
||||
|
||||
"@typescript-eslint/type-utils": ["@typescript-eslint/type-utils@6.21.0", "", { "dependencies": { "@typescript-eslint/typescript-estree": "6.21.0", "@typescript-eslint/utils": "6.21.0", "debug": "^4.3.4", "ts-api-utils": "^1.0.1" }, "peerDependencies": { "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
"@typescript-eslint/type-utils": ["@typescript-eslint/type-utils@7.18.0", "", { "dependencies": { "@typescript-eslint/typescript-estree": "7.18.0", "@typescript-eslint/utils": "7.18.0", "debug": "^4.3.4", "ts-api-utils": "^1.3.0" }, "peerDependencies": { "eslint": "^8.56.0" } }, "sha512-XL0FJXuCLaDuX2sYqZUUSOJ2sG5/i1AAze+axqmLnSkNEVMVYLF+cbwlB2w8D1tinFuSikHmFta+P+HOofrLeA=="],
|
||||
|
||||
"@typescript-eslint/types": ["@typescript-eslint/types@6.21.0", "", {}, ""],
|
||||
"@typescript-eslint/types": ["@typescript-eslint/types@7.18.0", "", {}, "sha512-iZqi+Ds1y4EDYUtlOOC+aUmxnE9xS/yCigkjA7XpTKV6nCBd3Hp/PRGGmdwnfkV2ThMyYldP1wRpm/id99spTQ=="],
|
||||
|
||||
"@typescript-eslint/typescript-estree": ["@typescript-eslint/typescript-estree@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4", "globby": "^11.1.0", "is-glob": "^4.0.3", "minimatch": "9.0.3", "semver": "^7.5.4", "ts-api-utils": "^1.0.1" } }, ""],
|
||||
"@typescript-eslint/typescript-estree": ["@typescript-eslint/typescript-estree@7.18.0", "", { "dependencies": { "@typescript-eslint/types": "7.18.0", "@typescript-eslint/visitor-keys": "7.18.0", "debug": "^4.3.4", "globby": "^11.1.0", "is-glob": "^4.0.3", "minimatch": "^9.0.4", "semver": "^7.6.0", "ts-api-utils": "^1.3.0" } }, "sha512-aP1v/BSPnnyhMHts8cf1qQ6Q1IFwwRvAQGRvBFkWlo3/lH29OXA3Pts+c10nxRxIBrDnoMqzhgdwVe5f2D6OzA=="],
|
||||
|
||||
"@typescript-eslint/utils": ["@typescript-eslint/utils@6.21.0", "", { "dependencies": { "@eslint-community/eslint-utils": "^4.4.0", "@types/json-schema": "^7.0.12", "@types/semver": "^7.5.0", "@typescript-eslint/scope-manager": "6.21.0", "@typescript-eslint/types": "6.21.0", "@typescript-eslint/typescript-estree": "6.21.0", "semver": "^7.5.4" }, "peerDependencies": { "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
"@typescript-eslint/utils": ["@typescript-eslint/utils@7.18.0", "", { "dependencies": { "@eslint-community/eslint-utils": "^4.4.0", "@typescript-eslint/scope-manager": "7.18.0", "@typescript-eslint/types": "7.18.0", "@typescript-eslint/typescript-estree": "7.18.0" }, "peerDependencies": { "eslint": "^8.56.0" } }, "sha512-kK0/rNa2j74XuHVcoCZxdFBMF+aq/vH83CXAOHieC+2Gis4mF8jJXT5eAfyD3K0sAxtPuwxaIOIOvhwzVDt/kw=="],
|
||||
|
||||
"@typescript-eslint/visitor-keys": ["@typescript-eslint/visitor-keys@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "eslint-visitor-keys": "^3.4.1" } }, ""],
|
||||
"@typescript-eslint/visitor-keys": ["@typescript-eslint/visitor-keys@7.18.0", "", { "dependencies": { "@typescript-eslint/types": "7.18.0", "eslint-visitor-keys": "^3.4.3" } }, "sha512-cDF0/Gf81QpY3xYyJKDV14Zwdmid5+uuENhjH2EqFaF0ni+yAyq/LzMaIJdhNJXZI7uLzwIlA+V7oWoyn6Curg=="],
|
||||
|
||||
"@ungap/structured-clone": ["@ungap/structured-clone@1.3.0", "", {}, ""],
|
||||
|
||||
"@vitest/coverage-v8": ["@vitest/coverage-v8@1.6.1", "", { "dependencies": { "@ampproject/remapping": "^2.2.1", "@bcoe/v8-coverage": "^0.2.3", "debug": "^4.3.4", "istanbul-lib-coverage": "^3.2.2", "istanbul-lib-report": "^3.0.1", "istanbul-lib-source-maps": "^5.0.4", "istanbul-reports": "^3.1.6", "magic-string": "^0.30.5", "magicast": "^0.3.3", "picocolors": "^1.0.0", "std-env": "^3.5.0", "strip-literal": "^2.0.0", "test-exclude": "^6.0.0" }, "peerDependencies": { "vitest": "1.6.1" } }, "sha512-6YeRZwuO4oTGKxD3bijok756oktHSIm3eczVVzNe3scqzuhLwltIF3S9ZL/vwOVIpURmU6SnZhziXXAfw8/Qlw=="],
|
||||
|
||||
"@vitest/expect": ["@vitest/expect@1.6.1", "", { "dependencies": { "@vitest/spy": "1.6.1", "@vitest/utils": "1.6.1", "chai": "^4.3.10" } }, "sha512-jXL+9+ZNIJKruofqXuuTClf44eSpcHlgj3CiuNihUF3Ioujtmc0zIa3UJOW5RjDK1YLBJZnWBlPuqhYycLioog=="],
|
||||
|
||||
"@vitest/runner": ["@vitest/runner@1.6.1", "", { "dependencies": { "@vitest/utils": "1.6.1", "p-limit": "^5.0.0", "pathe": "^1.1.1" } }, "sha512-3nSnYXkVkf3mXFfE7vVyPmi3Sazhb/2cfZGGs0JRzFsPFvAMBEcrweV1V1GsrstdXeKCTXlJbvnQwGWgEIHmOA=="],
|
||||
|
|
@ -207,7 +284,7 @@
|
|||
|
||||
"ajv": ["ajv@6.12.6", "", { "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", "json-schema-traverse": "^0.4.1", "uri-js": "^4.2.2" } }, ""],
|
||||
|
||||
"ansi-regex": ["ansi-regex@5.0.1", "", {}, ""],
|
||||
"ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
|
||||
|
||||
"ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, ""],
|
||||
|
||||
|
|
@ -223,20 +300,28 @@
|
|||
|
||||
"braces": ["braces@3.0.3", "", { "dependencies": { "fill-range": "^7.1.1" } }, ""],
|
||||
|
||||
"bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
|
||||
|
||||
"cac": ["cac@6.7.14", "", {}, "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ=="],
|
||||
|
||||
"callsites": ["callsites@3.1.0", "", {}, ""],
|
||||
|
||||
"chai": ["chai@4.5.0", "", { "dependencies": { "assertion-error": "^1.1.0", "check-error": "^1.0.3", "deep-eql": "^4.1.3", "get-func-name": "^2.0.2", "loupe": "^2.3.6", "pathval": "^1.1.1", "type-detect": "^4.1.0" } }, "sha512-RITGBfijLkBddZvnn8jdqoTypxvqbOLYQkGGxXzeFjVHvudaPw0HNFD9x928/eUwYWd2dPCugVqspGALTZZQKw=="],
|
||||
|
||||
"chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, ""],
|
||||
"chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
|
||||
|
||||
"check-error": ["check-error@1.0.3", "", { "dependencies": { "get-func-name": "^2.0.2" } }, "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg=="],
|
||||
|
||||
"cli-cursor": ["cli-cursor@5.0.0", "", { "dependencies": { "restore-cursor": "^5.0.0" } }, "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw=="],
|
||||
|
||||
"cli-spinners": ["cli-spinners@2.9.2", "", {}, "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg=="],
|
||||
|
||||
"color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, ""],
|
||||
|
||||
"color-name": ["color-name@1.1.4", "", {}, ""],
|
||||
|
||||
"commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
|
||||
|
||||
"concat-map": ["concat-map@0.0.1", "", {}, "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg=="],
|
||||
|
||||
"confbox": ["confbox@0.1.8", "", {}, "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w=="],
|
||||
|
|
@ -255,6 +340,8 @@
|
|||
|
||||
"doctrine": ["doctrine@3.0.0", "", { "dependencies": { "esutils": "^2.0.2" } }, ""],
|
||||
|
||||
"emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
|
||||
|
||||
"esbuild": ["esbuild@0.25.12", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.25.12", "@esbuild/android-arm": "0.25.12", "@esbuild/android-arm64": "0.25.12", "@esbuild/android-x64": "0.25.12", "@esbuild/darwin-arm64": "0.25.12", "@esbuild/darwin-x64": "0.25.12", "@esbuild/freebsd-arm64": "0.25.12", "@esbuild/freebsd-x64": "0.25.12", "@esbuild/linux-arm": "0.25.12", "@esbuild/linux-arm64": "0.25.12", "@esbuild/linux-ia32": "0.25.12", "@esbuild/linux-loong64": "0.25.12", "@esbuild/linux-mips64el": "0.25.12", "@esbuild/linux-ppc64": "0.25.12", "@esbuild/linux-riscv64": "0.25.12", "@esbuild/linux-s390x": "0.25.12", "@esbuild/linux-x64": "0.25.12", "@esbuild/netbsd-arm64": "0.25.12", "@esbuild/netbsd-x64": "0.25.12", "@esbuild/openbsd-arm64": "0.25.12", "@esbuild/openbsd-x64": "0.25.12", "@esbuild/openharmony-arm64": "0.25.12", "@esbuild/sunos-x64": "0.25.12", "@esbuild/win32-arm64": "0.25.12", "@esbuild/win32-ia32": "0.25.12", "@esbuild/win32-x64": "0.25.12" }, "bin": "bin/esbuild" }, ""],
|
||||
|
||||
"escape-string-regexp": ["escape-string-regexp@4.0.0", "", {}, ""],
|
||||
|
|
@ -267,6 +354,8 @@
|
|||
|
||||
"espree": ["espree@9.6.1", "", { "dependencies": { "acorn": "^8.9.0", "acorn-jsx": "^5.3.2", "eslint-visitor-keys": "^3.4.1" } }, ""],
|
||||
|
||||
"esprima": ["esprima@4.0.1", "", { "bin": { "esparse": "./bin/esparse.js", "esvalidate": "./bin/esvalidate.js" } }, "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A=="],
|
||||
|
||||
"esquery": ["esquery@1.6.0", "", { "dependencies": { "estraverse": "^5.1.0" } }, ""],
|
||||
|
||||
"esrecurse": ["esrecurse@4.3.0", "", { "dependencies": { "estraverse": "^5.2.0" } }, ""],
|
||||
|
|
@ -279,6 +368,8 @@
|
|||
|
||||
"execa": ["execa@8.0.1", "", { "dependencies": { "cross-spawn": "^7.0.3", "get-stream": "^8.0.1", "human-signals": "^5.0.0", "is-stream": "^3.0.0", "merge-stream": "^2.0.0", "npm-run-path": "^5.1.0", "onetime": "^6.0.0", "signal-exit": "^4.1.0", "strip-final-newline": "^3.0.0" } }, "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg=="],
|
||||
|
||||
"extend-shallow": ["extend-shallow@2.0.1", "", { "dependencies": { "is-extendable": "^0.1.0" } }, "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug=="],
|
||||
|
||||
"fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
|
||||
|
||||
"fast-glob": ["fast-glob@3.3.3", "", { "dependencies": { "@nodelib/fs.stat": "^2.0.2", "@nodelib/fs.walk": "^1.2.3", "glob-parent": "^5.1.2", "merge2": "^1.3.0", "micromatch": "^4.0.8" } }, ""],
|
||||
|
|
@ -303,6 +394,8 @@
|
|||
|
||||
"fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
|
||||
|
||||
"get-east-asian-width": ["get-east-asian-width@1.5.0", "", {}, "sha512-CQ+bEO+Tva/qlmw24dCejulK5pMzVnUOFOijVogd3KQs07HnRIgp8TGipvCCRT06xeYEbpbgwaCxglFyiuIcmA=="],
|
||||
|
||||
"get-func-name": ["get-func-name@2.0.2", "", {}, "sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ=="],
|
||||
|
||||
"get-stream": ["get-stream@8.0.1", "", {}, "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA=="],
|
||||
|
|
@ -319,8 +412,12 @@
|
|||
|
||||
"graphemer": ["graphemer@1.4.0", "", {}, ""],
|
||||
|
||||
"gray-matter": ["gray-matter@4.0.3", "", { "dependencies": { "js-yaml": "^3.13.1", "kind-of": "^6.0.2", "section-matter": "^1.0.0", "strip-bom-string": "^1.0.0" } }, "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q=="],
|
||||
|
||||
"has-flag": ["has-flag@4.0.0", "", {}, ""],
|
||||
|
||||
"html-escaper": ["html-escaper@2.0.2", "", {}, "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg=="],
|
||||
|
||||
"human-signals": ["human-signals@5.0.0", "", {}, "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ=="],
|
||||
|
||||
"ignore": ["ignore@5.3.2", "", {}, ""],
|
||||
|
|
@ -333,18 +430,32 @@
|
|||
|
||||
"inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
|
||||
|
||||
"is-extendable": ["is-extendable@0.1.1", "", {}, "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw=="],
|
||||
|
||||
"is-extglob": ["is-extglob@2.1.1", "", {}, ""],
|
||||
|
||||
"is-glob": ["is-glob@4.0.3", "", { "dependencies": { "is-extglob": "^2.1.1" } }, ""],
|
||||
|
||||
"is-interactive": ["is-interactive@2.0.0", "", {}, "sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ=="],
|
||||
|
||||
"is-number": ["is-number@7.0.0", "", {}, ""],
|
||||
|
||||
"is-path-inside": ["is-path-inside@3.0.3", "", {}, ""],
|
||||
|
||||
"is-stream": ["is-stream@3.0.0", "", {}, "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA=="],
|
||||
|
||||
"is-unicode-supported": ["is-unicode-supported@2.1.0", "", {}, "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ=="],
|
||||
|
||||
"isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
|
||||
|
||||
"istanbul-lib-coverage": ["istanbul-lib-coverage@3.2.2", "", {}, "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg=="],
|
||||
|
||||
"istanbul-lib-report": ["istanbul-lib-report@3.0.1", "", { "dependencies": { "istanbul-lib-coverage": "^3.0.0", "make-dir": "^4.0.0", "supports-color": "^7.1.0" } }, "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw=="],
|
||||
|
||||
"istanbul-lib-source-maps": ["istanbul-lib-source-maps@5.0.6", "", { "dependencies": { "@jridgewell/trace-mapping": "^0.3.23", "debug": "^4.1.1", "istanbul-lib-coverage": "^3.0.0" } }, "sha512-yg2d+Em4KizZC5niWhQaIomgf5WlL4vOOjZ5xGCmF8SnPE/mDWWXgvRExdcpCgh9lLRRa1/fSYp2ymmbJ1pI+A=="],
|
||||
|
||||
"istanbul-reports": ["istanbul-reports@3.2.0", "", { "dependencies": { "html-escaper": "^2.0.0", "istanbul-lib-report": "^3.0.0" } }, "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA=="],
|
||||
|
||||
"js-tokens": ["js-tokens@9.0.1", "", {}, "sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ=="],
|
||||
|
||||
"js-yaml": ["js-yaml@4.1.1", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": "bin/js-yaml.js" }, ""],
|
||||
|
|
@ -357,6 +468,8 @@
|
|||
|
||||
"keyv": ["keyv@4.5.4", "", { "dependencies": { "json-buffer": "3.0.1" } }, ""],
|
||||
|
||||
"kind-of": ["kind-of@6.0.3", "", {}, "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw=="],
|
||||
|
||||
"levn": ["levn@0.4.1", "", { "dependencies": { "prelude-ls": "^1.2.1", "type-check": "~0.4.0" } }, ""],
|
||||
|
||||
"local-pkg": ["local-pkg@0.5.1", "", { "dependencies": { "mlly": "^1.7.3", "pkg-types": "^1.2.1" } }, "sha512-9rrA30MRRP3gBD3HTGnC6cDFpaE1kVDWxWgqWJUN0RvDNAo+Nz/9GxB+nHOH0ifbVFy0hSA1V6vFDvnx54lTEQ=="],
|
||||
|
|
@ -365,12 +478,18 @@
|
|||
|
||||
"lodash.merge": ["lodash.merge@4.6.2", "", {}, ""],
|
||||
|
||||
"log-symbols": ["log-symbols@6.0.0", "", { "dependencies": { "chalk": "^5.3.0", "is-unicode-supported": "^1.3.0" } }, "sha512-i24m8rpwhmPIS4zscNzK6MSEhk0DUWa/8iYQWxhffV8jkI4Phvs3F+quL5xvS0gdQR0FyTCMMH33Y78dDTzzIw=="],
|
||||
|
||||
"loupe": ["loupe@2.3.7", "", { "dependencies": { "get-func-name": "^2.0.1" } }, "sha512-zSMINGVYkdpYSOBmLi0D1Uo7JU9nVdQKrHxC8eYlV+9YKK9WePqAlL7lSlorG/U2Fw1w0hTBmaa/jrQ3UbPHtA=="],
|
||||
|
||||
"lru-cache": ["lru-cache@11.2.2", "", {}, ""],
|
||||
|
||||
"magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
|
||||
|
||||
"magicast": ["magicast@0.3.5", "", { "dependencies": { "@babel/parser": "^7.25.4", "@babel/types": "^7.25.4", "source-map-js": "^1.2.0" } }, "sha512-L0WhttDl+2BOsybvEOLK7fW3UA0OQ0IQ2d6Zl2x/a6vVRs3bAY0ECOSHHeL5jD+SbOpOCUEi0y1DgHEn9Qn1AQ=="],
|
||||
|
||||
"make-dir": ["make-dir@4.0.0", "", { "dependencies": { "semver": "^7.5.3" } }, "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw=="],
|
||||
|
||||
"merge-stream": ["merge-stream@2.0.0", "", {}, "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w=="],
|
||||
|
||||
"merge2": ["merge2@1.4.1", "", {}, ""],
|
||||
|
|
@ -379,6 +498,8 @@
|
|||
|
||||
"mimic-fn": ["mimic-fn@4.0.0", "", {}, "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw=="],
|
||||
|
||||
"mimic-function": ["mimic-function@5.0.1", "", {}, "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA=="],
|
||||
|
||||
"minimatch": ["minimatch@10.1.1", "", { "dependencies": { "@isaacs/brace-expansion": "^5.0.0" } }, ""],
|
||||
|
||||
"minipass": ["minipass@7.1.2", "", {}, ""],
|
||||
|
|
@ -399,6 +520,8 @@
|
|||
|
||||
"optionator": ["optionator@0.9.4", "", { "dependencies": { "deep-is": "^0.1.3", "fast-levenshtein": "^2.0.6", "levn": "^0.4.1", "prelude-ls": "^1.2.1", "type-check": "^0.4.0", "word-wrap": "^1.2.5" } }, ""],
|
||||
|
||||
"ora": ["ora@8.2.0", "", { "dependencies": { "chalk": "^5.3.0", "cli-cursor": "^5.0.0", "cli-spinners": "^2.9.2", "is-interactive": "^2.0.0", "is-unicode-supported": "^2.0.0", "log-symbols": "^6.0.0", "stdin-discarder": "^0.2.2", "string-width": "^7.2.0", "strip-ansi": "^7.1.0" } }, "sha512-weP+BZ8MVNnlCm8c0Qdc1WSWq4Qn7I+9CJGm7Qali6g44e/PUzbjNqJX5NJ9ljlNMosfJvg1fKEGILklK9cwnw=="],
|
||||
|
||||
"p-limit": ["p-limit@5.0.0", "", { "dependencies": { "yocto-queue": "^1.0.0" } }, "sha512-/Eaoq+QyLSiXQ4lyYV23f14mZRQcXnxfHrN0vCai+ak9G0pp9iEQukIIZq5NccEvwRB8PUnZT0KsOoDCINS1qQ=="],
|
||||
|
||||
"p-locate": ["p-locate@5.0.0", "", { "dependencies": { "p-limit": "^3.0.2" } }, ""],
|
||||
|
|
@ -441,6 +564,8 @@
|
|||
|
||||
"resolve-pkg-maps": ["resolve-pkg-maps@1.0.0", "", {}, ""],
|
||||
|
||||
"restore-cursor": ["restore-cursor@5.1.0", "", { "dependencies": { "onetime": "^7.0.0", "signal-exit": "^4.1.0" } }, "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA=="],
|
||||
|
||||
"reusify": ["reusify@1.1.0", "", {}, ""],
|
||||
|
||||
"rimraf": ["rimraf@3.0.2", "", { "dependencies": { "glob": "^7.1.3" }, "bin": "bin.js" }, ""],
|
||||
|
|
@ -449,6 +574,8 @@
|
|||
|
||||
"run-parallel": ["run-parallel@1.2.0", "", { "dependencies": { "queue-microtask": "^1.2.2" } }, ""],
|
||||
|
||||
"section-matter": ["section-matter@1.0.0", "", { "dependencies": { "extend-shallow": "^2.0.1", "kind-of": "^6.0.0" } }, "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA=="],
|
||||
|
||||
"semver": ["semver@7.7.3", "", { "bin": "bin/semver.js" }, ""],
|
||||
|
||||
"shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
|
||||
|
|
@ -463,11 +590,19 @@
|
|||
|
||||
"source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
|
||||
|
||||
"sprintf-js": ["sprintf-js@1.0.3", "", {}, "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g=="],
|
||||
|
||||
"stackback": ["stackback@0.0.2", "", {}, "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw=="],
|
||||
|
||||
"std-env": ["std-env@3.10.0", "", {}, "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg=="],
|
||||
|
||||
"strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, ""],
|
||||
"stdin-discarder": ["stdin-discarder@0.2.2", "", {}, "sha512-UhDfHmA92YAlNnCfhmq0VeNL5bDbiZGg7sZ2IvPsXubGkiNa9EC+tUTsjBRsYUAz87btI6/1wf4XoVvQ3uRnmQ=="],
|
||||
|
||||
"string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
|
||||
|
||||
"strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
|
||||
|
||||
"strip-bom-string": ["strip-bom-string@1.0.0", "", {}, "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g=="],
|
||||
|
||||
"strip-final-newline": ["strip-final-newline@3.0.0", "", {}, "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw=="],
|
||||
|
||||
|
|
@ -477,6 +612,8 @@
|
|||
|
||||
"supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, ""],
|
||||
|
||||
"test-exclude": ["test-exclude@6.0.0", "", { "dependencies": { "@istanbuljs/schema": "^0.1.2", "glob": "^7.1.4", "minimatch": "^3.0.4" } }, "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w=="],
|
||||
|
||||
"text-table": ["text-table@0.2.0", "", {}, ""],
|
||||
|
||||
"tinybench": ["tinybench@2.9.0", "", {}, "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg=="],
|
||||
|
|
@ -529,12 +666,24 @@
|
|||
|
||||
"@humanwhocodes/config-array/minimatch": ["minimatch@3.1.2", "", { "dependencies": { "brace-expansion": "^1.1.7" } }, ""],
|
||||
|
||||
"@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.3", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, ""],
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin": ["@typescript-eslint/eslint-plugin@6.21.0", "", { "dependencies": { "@eslint-community/regexpp": "^4.5.1", "@typescript-eslint/scope-manager": "6.21.0", "@typescript-eslint/type-utils": "6.21.0", "@typescript-eslint/utils": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4", "graphemer": "^1.4.0", "ignore": "^5.2.4", "natural-compare": "^1.4.0", "semver": "^7.5.4", "ts-api-utils": "^1.0.1" }, "peerDependencies": { "@typescript-eslint/parser": "^6.0.0 || ^6.0.0-alpha", "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser": ["@typescript-eslint/parser@6.21.0", "", { "dependencies": { "@typescript-eslint/scope-manager": "6.21.0", "@typescript-eslint/types": "6.21.0", "@typescript-eslint/typescript-estree": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4" }, "peerDependencies": { "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
|
||||
"@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.5", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow=="],
|
||||
|
||||
"eslint/chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, ""],
|
||||
|
||||
"eslint/minimatch": ["minimatch@3.1.2", "", { "dependencies": { "brace-expansion": "^1.1.7" } }, ""],
|
||||
|
||||
"eslint/strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, ""],
|
||||
|
||||
"fast-glob/glob-parent": ["glob-parent@5.1.2", "", { "dependencies": { "is-glob": "^4.0.1" } }, ""],
|
||||
|
||||
"gray-matter/js-yaml": ["js-yaml@3.14.2", "", { "dependencies": { "argparse": "^1.0.7", "esprima": "^4.0.0" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg=="],
|
||||
|
||||
"log-symbols/is-unicode-supported": ["is-unicode-supported@1.3.0", "", {}, "sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ=="],
|
||||
|
||||
"mlly/pathe": ["pathe@2.0.3", "", {}, "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w=="],
|
||||
|
||||
"npm-run-path/path-key": ["path-key@4.0.0", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],
|
||||
|
|
@ -545,16 +694,38 @@
|
|||
|
||||
"pretty-format/ansi-styles": ["ansi-styles@5.2.0", "", {}, "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA=="],
|
||||
|
||||
"restore-cursor/onetime": ["onetime@7.0.0", "", { "dependencies": { "mimic-function": "^5.0.0" } }, "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ=="],
|
||||
|
||||
"rimraf/glob": ["glob@7.2.3", "", { "dependencies": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", "inherits": "2", "minimatch": "^3.1.1", "once": "^1.3.0", "path-is-absolute": "^1.0.0" } }, ""],
|
||||
|
||||
"test-exclude/glob": ["glob@7.2.3", "", { "dependencies": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", "inherits": "2", "minimatch": "^3.1.1", "once": "^1.3.0", "path-is-absolute": "^1.0.0" } }, ""],
|
||||
|
||||
"test-exclude/minimatch": ["minimatch@3.1.2", "", { "dependencies": { "brace-expansion": "^1.1.7" } }, ""],
|
||||
|
||||
"vite/esbuild": ["esbuild@0.21.5", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.21.5", "@esbuild/android-arm": "0.21.5", "@esbuild/android-arm64": "0.21.5", "@esbuild/android-x64": "0.21.5", "@esbuild/darwin-arm64": "0.21.5", "@esbuild/darwin-x64": "0.21.5", "@esbuild/freebsd-arm64": "0.21.5", "@esbuild/freebsd-x64": "0.21.5", "@esbuild/linux-arm": "0.21.5", "@esbuild/linux-arm64": "0.21.5", "@esbuild/linux-ia32": "0.21.5", "@esbuild/linux-loong64": "0.21.5", "@esbuild/linux-mips64el": "0.21.5", "@esbuild/linux-ppc64": "0.21.5", "@esbuild/linux-riscv64": "0.21.5", "@esbuild/linux-s390x": "0.21.5", "@esbuild/linux-x64": "0.21.5", "@esbuild/netbsd-x64": "0.21.5", "@esbuild/openbsd-x64": "0.21.5", "@esbuild/sunos-x64": "0.21.5", "@esbuild/win32-arm64": "0.21.5", "@esbuild/win32-ia32": "0.21.5", "@esbuild/win32-x64": "0.21.5" }, "bin": "bin/esbuild" }, "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw=="],
|
||||
|
||||
"@eslint/eslintrc/minimatch/brace-expansion": ["brace-expansion@1.1.12", "", { "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" } }, ""],
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/scope-manager": ["@typescript-eslint/scope-manager@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0" } }, ""],
|
||||
|
||||
"@humanwhocodes/config-array/minimatch/brace-expansion": ["brace-expansion@1.1.12", "", { "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" } }, ""],
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/type-utils": ["@typescript-eslint/type-utils@6.21.0", "", { "dependencies": { "@typescript-eslint/typescript-estree": "6.21.0", "@typescript-eslint/utils": "6.21.0", "debug": "^4.3.4", "ts-api-utils": "^1.0.1" }, "peerDependencies": { "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/utils": ["@typescript-eslint/utils@6.21.0", "", { "dependencies": { "@eslint-community/eslint-utils": "^4.4.0", "@types/json-schema": "^7.0.12", "@types/semver": "^7.5.0", "@typescript-eslint/scope-manager": "6.21.0", "@typescript-eslint/types": "6.21.0", "@typescript-eslint/typescript-estree": "6.21.0", "semver": "^7.5.4" }, "peerDependencies": { "eslint": "^7.0.0 || ^8.0.0" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/visitor-keys": ["@typescript-eslint/visitor-keys@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "eslint-visitor-keys": "^3.4.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser/@typescript-eslint/scope-manager": ["@typescript-eslint/scope-manager@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser/@typescript-eslint/types": ["@typescript-eslint/types@6.21.0", "", {}, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser/@typescript-eslint/typescript-estree": ["@typescript-eslint/typescript-estree@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4", "globby": "^11.1.0", "is-glob": "^4.0.3", "minimatch": "9.0.3", "semver": "^7.5.4", "ts-api-utils": "^1.0.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser/@typescript-eslint/visitor-keys": ["@typescript-eslint/visitor-keys@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "eslint-visitor-keys": "^3.4.1" } }, ""],
|
||||
|
||||
"@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, ""],
|
||||
|
||||
"eslint/strip-ansi/ansi-regex": ["ansi-regex@5.0.1", "", {}, ""],
|
||||
|
||||
"gray-matter/js-yaml/argparse": ["argparse@1.0.10", "", { "dependencies": { "sprintf-js": "~1.0.2" } }, "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg=="],
|
||||
|
||||
"p-locate/p-limit/yocto-queue": ["yocto-queue@0.1.0", "", {}, ""],
|
||||
|
||||
"rimraf/glob/minimatch": ["minimatch@3.1.2", "", { "dependencies": { "brace-expansion": "^1.1.7" } }, ""],
|
||||
|
|
@ -605,6 +776,28 @@
|
|||
|
||||
"vite/esbuild/@esbuild/win32-x64": ["@esbuild/win32-x64@0.21.5", "", { "os": "win32", "cpu": "x64" }, "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw=="],
|
||||
|
||||
"rimraf/glob/minimatch/brace-expansion": ["brace-expansion@1.1.12", "", { "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" } }, ""],
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/scope-manager/@typescript-eslint/types": ["@typescript-eslint/types@6.21.0", "", {}, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/type-utils/@typescript-eslint/typescript-estree": ["@typescript-eslint/typescript-estree@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4", "globby": "^11.1.0", "is-glob": "^4.0.3", "minimatch": "9.0.3", "semver": "^7.5.4", "ts-api-utils": "^1.0.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/utils/@typescript-eslint/types": ["@typescript-eslint/types@6.21.0", "", {}, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/utils/@typescript-eslint/typescript-estree": ["@typescript-eslint/typescript-estree@6.21.0", "", { "dependencies": { "@typescript-eslint/types": "6.21.0", "@typescript-eslint/visitor-keys": "6.21.0", "debug": "^4.3.4", "globby": "^11.1.0", "is-glob": "^4.0.3", "minimatch": "9.0.3", "semver": "^7.5.4", "ts-api-utils": "^1.0.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/visitor-keys/@typescript-eslint/types": ["@typescript-eslint/types@6.21.0", "", {}, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser/@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.3", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/type-utils/@typescript-eslint/typescript-estree/@typescript-eslint/types": ["@typescript-eslint/types@6.21.0", "", {}, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/type-utils/@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.3", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/utils/@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.3", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/parser/@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/type-utils/@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, ""],
|
||||
|
||||
"@opencode-agents/eval-framework/@typescript-eslint/eslint-plugin/@typescript-eslint/utils/@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, ""],
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -7,7 +7,15 @@
|
|||
|
||||
---
|
||||
|
||||
## 📁 Planning Documents
|
||||
## 🎯 MVP Plan (START HERE)
|
||||
|
||||
**`mvp/00-MVP-PLAN.md`** — The 20% that delivers 80% of the value.
|
||||
5 commands, 6 weeks, focused on what users actually care about.
|
||||
This is what we build first. Everything else is v1.1+.
|
||||
|
||||
---
|
||||
|
||||
## 📁 Full Planning Documents (Reference)
|
||||
|
||||
### Core Planning
|
||||
|
||||
|
|
|
|||
1875
docs/planning/12-MASTER-SYNTHESIS.md
Normal file
1875
docs/planning/12-MASTER-SYNTHESIS.md
Normal file
File diff suppressed because it is too large
Load diff
1330
docs/planning/13-PROJECT-BREAKDOWN.md
Normal file
1330
docs/planning/13-PROJECT-BREAKDOWN.md
Normal file
File diff suppressed because it is too large
Load diff
1335
docs/planning/14-PROVIDER-PATTERN-FINAL.md
Normal file
1335
docs/planning/14-PROVIDER-PATTERN-FINAL.md
Normal file
File diff suppressed because it is too large
Load diff
606
docs/planning/mvp/00-MVP-PLAN.md
Normal file
606
docs/planning/mvp/00-MVP-PLAN.md
Normal file
|
|
@ -0,0 +1,606 @@
|
|||
# OAC MVP — The 20% That Delivers 80% of the Value
|
||||
|
||||
**Date**: 2026-02-19
|
||||
**Status**: ACTIVE — This is what we build first
|
||||
**Branch**: `feature/oac-package-refactor`
|
||||
**Issue**: #206
|
||||
|
||||
---
|
||||
|
||||
## The Aim
|
||||
|
||||
**One sentence**: Make it dead simple to install, manage, and keep updated a set of excellent AI agents and context files across any IDE — and get out of the user's way.
|
||||
|
||||
**What users actually want**:
|
||||
1. "Set me up fast so I can code with AI" → `oac init`
|
||||
2. "Keep my stuff updated without breaking my changes" → `oac update`
|
||||
3. "Work with whatever IDE I'm in" → `oac apply`
|
||||
4. "Let me grab the context/agents I need" → `oac add`
|
||||
5. "Tell me if something's wrong" → `oac doctor`
|
||||
|
||||
**What users do NOT want**: Provider interfaces, 6-layer resolution theory, preset merge strategies, TUI browsers, community registries, plugin architectures. Those are our problems, not theirs.
|
||||
|
||||
---
|
||||
|
||||
## The Focus
|
||||
|
||||
### The Product is the CONTENT, Not the CLI
|
||||
|
||||
The agents, context files, and skills we ship are the product. The CLI is a delivery truck. If the agents are mediocre, the fanciest CLI won't save us. If the agents are excellent, even a basic CLI wins.
|
||||
|
||||
**Priority order**:
|
||||
1. Excellent bundled content (agents + context)
|
||||
2. Reliable install/update that respects user changes
|
||||
3. Multi-IDE output generation
|
||||
4. Everything else
|
||||
|
||||
### Context System is the Core Value
|
||||
|
||||
Context files are what make AI agents actually useful in a project. Without project-specific context (coding standards, architecture patterns, domain knowledge), agents give generic answers. With good context, they give great answers.
|
||||
|
||||
**The context system must**:
|
||||
- Let users install curated context files easily
|
||||
- Let users add/remove individual context files
|
||||
- Let users override any context file with their own version
|
||||
- Keep bundled context updated without touching user overrides
|
||||
- Work offline (bundled in npm, no network fetch at runtime)
|
||||
|
||||
---
|
||||
|
||||
## 5 Commands. That's the MVP.
|
||||
|
||||
```
|
||||
oac init Set up agents + context in my project
|
||||
oac update Update everything, skip what I changed
|
||||
oac apply Generate files for Cursor/Claude/Windsurf
|
||||
oac add <thing> Add a specific agent, context file, or skill
|
||||
oac doctor Tell me what's broken and how to fix it
|
||||
```
|
||||
|
||||
Plus these flags that work on any command:
|
||||
```
|
||||
--yolo Skip all confirmations (auto-enabled when CI=true)
|
||||
--dry-run Show what would happen without doing it
|
||||
--verbose Show detailed output
|
||||
```
|
||||
|
||||
And one bonus for discoverability:
|
||||
```
|
||||
oac list Show what's installed
|
||||
oac status One-screen summary of everything
|
||||
```
|
||||
|
||||
That's 7 commands total. Nothing else ships in v1.0.
|
||||
|
||||
---
|
||||
|
||||
## What "Done" Looks Like — The Passing State
|
||||
|
||||
### Gate 1: `oac init` Works (Week 2)
|
||||
|
||||
**User runs**: `npx @nextsystems/oac init`
|
||||
|
||||
**What happens**:
|
||||
1. Detects current directory (must be a project root — has `package.json` or `.git`)
|
||||
2. Auto-detects IDEs present (`.opencode/`, `.cursor/`, `.claude/`)
|
||||
3. Asks ONE question: "Install standard agent pack? (Y/n)"
|
||||
4. Copies bundled agents + context to `.opencode/`
|
||||
5. Writes `.oac/manifest.json` (tracks what was installed + SHA256 of each file)
|
||||
6. Writes `.oac/config.json` (minimal defaults)
|
||||
7. Prints: "Done! X agents and Y context files installed. Run `oac doctor` to verify."
|
||||
|
||||
**Passing criteria**:
|
||||
- [ ] Completes in < 30 seconds on a cold run
|
||||
- [ ] `npx @nextsystems/oac init` works (no global install required)
|
||||
- [ ] Idempotent — running twice doesn't duplicate or break anything
|
||||
- [ ] Skips files that already exist (prints "skipped: already exists")
|
||||
- [ ] Works on macOS, Linux, Windows
|
||||
- [ ] Zero interactive prompts with `--yolo` flag
|
||||
- [ ] `CI=true` environment auto-enables `--yolo`
|
||||
- [ ] Exit code 0 on success, non-zero on failure
|
||||
|
||||
**What it installs by default**:
|
||||
```
|
||||
.opencode/
|
||||
├── agent/
|
||||
│ ├── core/
|
||||
│ │ ├── openagent.md # Primary orchestrator
|
||||
│ │ └── opencoder.md # Code implementation
|
||||
│ ├── development/
|
||||
│ │ ├── TestEngineer.md
|
||||
│ │ ├── CodeReviewer.md
|
||||
│ │ ├── CoderAgent.md
|
||||
│ │ └── BuildAgent.md
|
||||
│ └── discovery/
|
||||
│ ├── ContextScout.md
|
||||
│ └── ExternalScout.md
|
||||
├── context/
|
||||
│ ├── core/
|
||||
│ │ └── standards/
|
||||
│ │ ├── code-quality.md
|
||||
│ │ ├── test-coverage.md
|
||||
│ │ └── security-patterns.md
|
||||
│ ├── development/
|
||||
│ │ └── principles/
|
||||
│ │ ├── clean-code.md
|
||||
│ │ └── api-design.md
|
||||
│ └── [project-intelligence templates]
|
||||
├── skills/
|
||||
│ ├── task-management/
|
||||
│ └── context-manager/
|
||||
├── config.json
|
||||
└── opencode.json
|
||||
|
||||
.oac/
|
||||
├── manifest.json # What OAC installed + SHA256 hashes
|
||||
└── config.json # User preferences
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Gate 2: `oac update` Works (Week 3)
|
||||
|
||||
**User runs**: `oac update`
|
||||
|
||||
**What happens**:
|
||||
1. Reads `.oac/manifest.json` (what's installed + original SHA256)
|
||||
2. Compares each installed file's current SHA256 against the manifest
|
||||
3. For each file:
|
||||
- SHA256 matches manifest → file is untouched → safe to update → update silently
|
||||
- SHA256 differs from manifest → user modified it → SKIP and report
|
||||
4. Copies new versions of safe-to-update files from npm bundle
|
||||
5. Updates `.oac/manifest.json` with new SHA256s
|
||||
6. Prints summary: "Updated X files. Skipped Y files (user-modified)."
|
||||
|
||||
**Passing criteria**:
|
||||
- [ ] Updates files the user hasn't touched
|
||||
- [ ] NEVER overwrites a file the user modified (unless `--yolo`)
|
||||
- [ ] `--yolo` creates `.oac/backups/{filename}.{timestamp}` before overwriting
|
||||
- [ ] `oac update --check` shows what WOULD change without changing anything
|
||||
- [ ] `oac update --dry-run` same as `--check` (alias)
|
||||
- [ ] Works when npm package has been updated (`npm update @nextsystems/oac`)
|
||||
- [ ] Handles new files (files in new version that didn't exist before → install them)
|
||||
- [ ] Handles removed files (files removed from new version → leave user's copy, warn)
|
||||
- [ ] Prints clear list: "Updated: file1, file2. Skipped (modified): file3. New: file4."
|
||||
|
||||
**The manifest format** (simple, not a full lockfile):
|
||||
```json
|
||||
{
|
||||
"version": "1",
|
||||
"oacVersion": "0.7.1",
|
||||
"installedAt": "2026-02-19T10:00:00Z",
|
||||
"updatedAt": "2026-02-19T10:00:00Z",
|
||||
"files": {
|
||||
".opencode/agent/core/openagent.md": {
|
||||
"sha256": "a1b2c3d4...",
|
||||
"source": "bundled",
|
||||
"installedAt": "2026-02-19T10:00:00Z"
|
||||
},
|
||||
".opencode/context/core/standards/code-quality.md": {
|
||||
"sha256": "e5f6a7b8...",
|
||||
"source": "bundled",
|
||||
"installedAt": "2026-02-19T10:00:00Z"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Gate 3: `oac add` Works for Context (Week 4)
|
||||
|
||||
**User runs**: `oac add context:react-patterns`
|
||||
|
||||
**What happens**:
|
||||
1. Looks up `react-patterns` in the bundled registry (`registry.json`)
|
||||
2. Finds the file path in the npm package
|
||||
3. Copies it to `.opencode/context/development/react-patterns.md`
|
||||
4. Updates `.oac/manifest.json`
|
||||
5. Prints: "Added react-patterns to .opencode/context/development/"
|
||||
|
||||
**Also supports**:
|
||||
```bash
|
||||
oac add agent:rust-specialist # Add a specific agent
|
||||
oac add skill:context-manager # Add a specific skill
|
||||
oac add context:typescript-patterns # Add a specific context file
|
||||
oac remove context:react-patterns # Remove something
|
||||
```
|
||||
|
||||
**Passing criteria**:
|
||||
- [ ] `oac add` with no args shows available components grouped by type
|
||||
- [ ] `oac add context:X` installs the context file to the right location
|
||||
- [ ] `oac add agent:X` installs the agent file to the right location
|
||||
- [ ] Warns if component already exists: "Already installed. Use --force to reinstall."
|
||||
- [ ] `oac remove X` removes the file and updates manifest
|
||||
- [ ] `oac list` shows all installed components with type and path
|
||||
- [ ] `oac list --context` filters to context files only
|
||||
- [ ] `oac list --agents` filters to agents only
|
||||
|
||||
**Why context is the priority for `add`**:
|
||||
Context files are the most granular, most frequently added/removed, and most project-specific. A Rust project needs different context than a React project. Users will `oac add context:rust-patterns` far more often than `oac add agent:X`.
|
||||
|
||||
---
|
||||
|
||||
### Gate 4: `oac apply` Works (Week 5)
|
||||
|
||||
**User runs**: `oac apply cursor`
|
||||
|
||||
**What happens**:
|
||||
1. Reads all installed agents from `.opencode/agent/`
|
||||
2. Uses the compatibility layer adapters (already built!) to convert
|
||||
3. Generates `.cursorrules` with a router pattern
|
||||
4. Prints: "Generated .cursorrules (45KB) with 6 agents."
|
||||
|
||||
**Also supports**:
|
||||
```bash
|
||||
oac apply claude # Generate CLAUDE.md
|
||||
oac apply windsurf # Generate .windsurfrules
|
||||
oac apply --all # Generate for all detected IDEs
|
||||
```
|
||||
|
||||
**Passing criteria**:
|
||||
- [ ] `oac apply cursor` generates valid `.cursorrules`
|
||||
- [ ] `oac apply claude` generates valid `CLAUDE.md`
|
||||
- [ ] `oac apply windsurf` generates valid `.windsurfrules`
|
||||
- [ ] `oac apply --all` detects which IDEs are present and generates for each
|
||||
- [ ] Warns about feature limitations: "Cursor: skills not supported, skipping 3 skills"
|
||||
- [ ] Warns about size: "Cursor: .cursorrules is 92KB (limit: 100KB) — consider removing agents"
|
||||
- [ ] `--dry-run` shows what would be generated without writing
|
||||
- [ ] Existing IDE files are backed up before overwriting (`.cursorrules.bak`)
|
||||
|
||||
**Key insight**: The compatibility layer adapters (`packages/compatibility-layer/`) already exist and work. This command is mostly wiring them to the CLI. Don't rewrite them.
|
||||
|
||||
---
|
||||
|
||||
### Gate 5: `oac doctor` Works (Week 5)
|
||||
|
||||
**User runs**: `oac doctor`
|
||||
|
||||
**What happens**:
|
||||
```
|
||||
OAC Doctor — Checking your setup...
|
||||
|
||||
✓ OAC version: 1.0.0 (latest)
|
||||
✓ Node.js: v20.11.0 (>= 18 required)
|
||||
✓ Config: .oac/config.json valid
|
||||
✓ Manifest: .oac/manifest.json valid
|
||||
✓ Agents: 8 installed, all files present
|
||||
✓ Context: 15 files installed, all files present
|
||||
✓ Skills: 3 installed, all files present
|
||||
⚠ Modified: 2 files modified since install
|
||||
- .opencode/agent/core/openagent.md (modified 2 days ago)
|
||||
- .opencode/context/core/standards/code-quality.md (modified 5 hours ago)
|
||||
✓ IDE: OpenCode detected (.opencode/)
|
||||
⚠ IDE: Cursor detected (.cursor/) — run 'oac apply cursor' to sync
|
||||
|
||||
Result: HEALTHY (2 warnings)
|
||||
```
|
||||
|
||||
**Passing criteria**:
|
||||
- [ ] Checks OAC version against npm registry (non-blocking, skip if offline)
|
||||
- [ ] Checks Node.js version >= 18
|
||||
- [ ] Validates `.oac/config.json` and `.oac/manifest.json` exist and are valid JSON
|
||||
- [ ] Verifies every file in manifest exists on disk
|
||||
- [ ] Reports which files have been modified (SHA256 mismatch)
|
||||
- [ ] Detects installed IDEs and suggests `oac apply` if out of sync
|
||||
- [ ] Exit code 0 if healthy, 1 if errors found
|
||||
- [ ] `oac doctor --json` outputs machine-readable JSON (for CI)
|
||||
|
||||
---
|
||||
|
||||
### Gate 6: `oac status` Works (Week 5)
|
||||
|
||||
**User runs**: `oac status`
|
||||
|
||||
**What happens**:
|
||||
```
|
||||
OAC v1.0.0 — ~/my-project
|
||||
|
||||
Agents: 8 installed (2 core, 6 subagents)
|
||||
Context: 15 files (12 bundled, 3 custom)
|
||||
Skills: 3 installed
|
||||
Modified: 2 files have local changes
|
||||
Updates: Available (run 'oac update --check')
|
||||
IDE: OpenCode (active), Cursor (needs sync)
|
||||
|
||||
Run 'oac doctor' for full health check
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## What We Build — Technical Breakdown
|
||||
|
||||
### Package: `packages/cli/`
|
||||
|
||||
New package. Commander.js CLI. This is the only new package for MVP.
|
||||
|
||||
```
|
||||
packages/cli/
|
||||
├── src/
|
||||
│ ├── commands/
|
||||
│ │ ├── init.ts # oac init
|
||||
│ │ ├── update.ts # oac update
|
||||
│ │ ├── add.ts # oac add / oac remove
|
||||
│ │ ├── apply.ts # oac apply
|
||||
│ │ ├── doctor.ts # oac doctor
|
||||
│ │ ├── list.ts # oac list
|
||||
│ │ └── status.ts # oac status
|
||||
│ ├── lib/
|
||||
│ │ ├── manifest.ts # Read/write .oac/manifest.json
|
||||
│ │ ├── config.ts # Read/write .oac/config.json
|
||||
│ │ ├── bundled.ts # Locate bundled files in npm package
|
||||
│ │ ├── sha256.ts # Compute file hashes
|
||||
│ │ ├── installer.ts # Copy files with conflict detection
|
||||
│ │ ├── registry.ts # Read registry.json, resolve components
|
||||
│ │ └── ide-detect.ts # Detect installed IDEs
|
||||
│ ├── ui/
|
||||
│ │ ├── logger.ts # Colored output (chalk)
|
||||
│ │ └── spinner.ts # Progress indication (ora)
|
||||
│ └── index.ts # Commander.js entry point
|
||||
├── package.json
|
||||
├── tsconfig.json
|
||||
└── tsup.config.ts
|
||||
```
|
||||
|
||||
### Dependencies (minimal)
|
||||
|
||||
```json
|
||||
{
|
||||
"dependencies": {
|
||||
"commander": "^12.0.0",
|
||||
"chalk": "^5.3.0",
|
||||
"ora": "^8.0.0",
|
||||
"fs-extra": "^11.2.0",
|
||||
"semver": "^7.6.0",
|
||||
"zod": "^3.23.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"tsup": "^8.0.0",
|
||||
"typescript": "^5.4.0",
|
||||
"vitest": "^1.5.0"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
No `@inquirer/prompts` (no interactive wizards in MVP).
|
||||
No `conf` (we write JSON directly).
|
||||
No `update-notifier` (doctor checks version manually).
|
||||
No `cli-progress` (ora spinner is enough).
|
||||
No `diff` (we don't show diffs in MVP, just skip modified files).
|
||||
No `gray-matter` (we don't parse frontmatter in the CLI).
|
||||
|
||||
### What We Reuse (Don't Rewrite)
|
||||
|
||||
| Existing Code | How We Use It |
|
||||
|---------------|---------------|
|
||||
| `packages/compatibility-layer/` | `oac apply` calls these adapters directly |
|
||||
| `registry.json` | `oac add` reads this to find components |
|
||||
| `.opencode/` bundled content | `oac init` copies from here |
|
||||
| `install.sh` | Keep as legacy fallback, deprecation notice |
|
||||
| `bin/oac.js` | Rewrite to: `require('../packages/cli/dist/index.js')` |
|
||||
|
||||
### What We Do NOT Build in MVP
|
||||
|
||||
| Feature | Why Not |
|
||||
|---------|---------|
|
||||
| `@nextsystems/oac-core` package | Provider interfaces are for v1.1 extensibility |
|
||||
| `oac.config.ts` | TypeScript config is a power-user feature |
|
||||
| `agent.json` + `prompt.md` split | Current `.md` format works fine, migrate later |
|
||||
| `oac.lock` lockfile | Manifest is enough for single-user, lockfile is for teams |
|
||||
| Preset system | Users can edit files directly for now |
|
||||
| TUI browser | `oac list` is enough for discovery |
|
||||
| Community publishing | No community yet |
|
||||
| Security scanning | No community components to scan yet |
|
||||
| OpenCode plugin (session.created) | Auto-update is nice-to-have, `oac update` is enough |
|
||||
| `oac browse` / `oac search` | `oac list` covers this |
|
||||
| `oac rollback` | `.oac/backups/` + git is enough |
|
||||
| `oac customize` / `oac presets` | Edit files directly |
|
||||
| `oac compat import` (toOAC) | One-way conversion is enough |
|
||||
| Multi-registry support | One registry is enough |
|
||||
| `oac publish` | No community yet |
|
||||
| `oac session` / `oac task` | Task management stays as-is |
|
||||
|
||||
---
|
||||
|
||||
## The Manifest — Our Source of Truth
|
||||
|
||||
The manifest is the simplest possible tracking system. Not a lockfile (no dependency resolution, no version ranges, no history). Just: "what did OAC install, and what was the hash?"
|
||||
|
||||
### `.oac/manifest.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"version": "1",
|
||||
"oacVersion": "1.0.0",
|
||||
"installedAt": "2026-02-19T10:00:00Z",
|
||||
"updatedAt": "2026-02-19T10:00:00Z",
|
||||
"files": {
|
||||
".opencode/agent/core/openagent.md": {
|
||||
"sha256": "a1b2c3d4e5f6...",
|
||||
"type": "agent",
|
||||
"source": "bundled",
|
||||
"installedAt": "2026-02-19T10:00:00Z"
|
||||
},
|
||||
".opencode/context/core/standards/code-quality.md": {
|
||||
"sha256": "f7e8d9c0b1a2...",
|
||||
"type": "context",
|
||||
"source": "bundled",
|
||||
"installedAt": "2026-02-19T10:00:00Z"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### `.oac/config.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"version": "1",
|
||||
"preferences": {
|
||||
"yoloMode": false,
|
||||
"autoBackup": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
That's it. No IDE config, no provider config, no registry config. Just user preferences.
|
||||
|
||||
---
|
||||
|
||||
## The Update Algorithm — The Core of the Whole System
|
||||
|
||||
This is the most important code in the entire project. Get this right and everything else follows.
|
||||
|
||||
```
|
||||
FOR each file in NEW npm bundle:
|
||||
IF file exists in manifest:
|
||||
currentHash = SHA256(file on disk)
|
||||
manifestHash = manifest.files[file].sha256
|
||||
|
||||
IF currentHash == manifestHash:
|
||||
→ File is UNTOUCHED by user
|
||||
→ SAFE to update
|
||||
→ Copy new version, update manifest hash
|
||||
ELSE:
|
||||
→ File was MODIFIED by user
|
||||
→ SKIP (unless --yolo)
|
||||
→ If --yolo: backup to .oac/backups/, then overwrite, update manifest
|
||||
ELSE:
|
||||
→ File is NEW in this version
|
||||
→ Install it, add to manifest
|
||||
|
||||
FOR each file in manifest NOT in new bundle:
|
||||
→ File was REMOVED from OAC
|
||||
→ Leave user's copy alone
|
||||
→ Remove from manifest
|
||||
→ Warn: "file.md is no longer maintained by OAC"
|
||||
```
|
||||
|
||||
This algorithm is simple, predictable, and safe. Users can always understand what happened by reading the output.
|
||||
|
||||
---
|
||||
|
||||
## Timeline
|
||||
|
||||
| Week | What Ships | Gate |
|
||||
|------|-----------|------|
|
||||
| **Week 1** | `packages/cli/` skeleton, `bin/oac.js` rewrite, build pipeline, `oac --version` works | — |
|
||||
| **Week 2** | `oac init` fully working, manifest system, bundled content copying | Gate 1 |
|
||||
| **Week 3** | `oac update` fully working, SHA256 comparison, skip-if-modified | Gate 2 |
|
||||
| **Week 4** | `oac add/remove`, `oac list`, registry.json reading | Gate 3 |
|
||||
| **Week 5** | `oac apply` (wire compatibility layer), `oac doctor`, `oac status` | Gate 4, 5, 6 |
|
||||
| **Week 6** | Testing, error messages, edge cases, documentation, npm publish prep | All gates pass |
|
||||
|
||||
**Total: 6 weeks to a shippable v1.0**
|
||||
|
||||
---
|
||||
|
||||
## What Comes After MVP (v1.1 Roadmap)
|
||||
|
||||
Once MVP ships and we have real users giving feedback:
|
||||
|
||||
| Feature | Trigger to Build |
|
||||
|---------|-----------------|
|
||||
| `oac.lock` lockfile | When teams ask for reproducible installs |
|
||||
| `agent.json` + `prompt.md` split | When we need programmatic agent management |
|
||||
| Provider interfaces (`oac-core`) | When someone wants to swap a subsystem |
|
||||
| `oac.config.ts` | When enterprise users need custom providers |
|
||||
| Preset system | When users complain about losing customizations on update |
|
||||
| TUI browser (`oac browse`) | When we have 50+ components and `oac list` isn't enough |
|
||||
| Community registry | When we have 1,000+ users and people want to share |
|
||||
| Security scanning | When community components exist |
|
||||
| OpenCode plugin (auto-update) | When users forget to run `oac update` |
|
||||
| `oac rollback` | When users ask for it (git covers most cases) |
|
||||
| GUI wrapper | When content creators are a real user segment |
|
||||
|
||||
**Rule: Don't build it until someone asks for it.**
|
||||
|
||||
---
|
||||
|
||||
## Non-Negotiable Quality Standards
|
||||
|
||||
### Every command must:
|
||||
- Print what it's about to do BEFORE doing it
|
||||
- Print what it did AFTER doing it
|
||||
- Support `--dry-run` to preview without executing
|
||||
- Support `--yolo` to skip confirmations
|
||||
- Return exit code 0 on success, non-zero on failure
|
||||
- Never silently fail — always print errors in plain English
|
||||
- Never modify a user-edited file without explicit consent
|
||||
|
||||
### Error messages must:
|
||||
- Say what went wrong
|
||||
- Say why it went wrong (if known)
|
||||
- Say how to fix it
|
||||
- Example: "Error: .oac/manifest.json not found. Run 'oac init' to set up your project."
|
||||
|
||||
### The CLI must:
|
||||
- Start in < 100ms (`oac --version` must be instant)
|
||||
- Use lazy imports (don't load commander commands until needed)
|
||||
- Work offline (all bundled content, no network required for core operations)
|
||||
- Work without global install (`npx @nextsystems/oac` must work)
|
||||
|
||||
---
|
||||
|
||||
## How to Validate the MVP is Right
|
||||
|
||||
### User Test 1: Fresh Project Setup
|
||||
```bash
|
||||
mkdir my-project && cd my-project && git init
|
||||
npx @nextsystems/oac init
|
||||
# Expected: agents + context installed in < 30 seconds
|
||||
# Expected: user can immediately start coding with AI
|
||||
```
|
||||
|
||||
### User Test 2: Update After Customization
|
||||
```bash
|
||||
# User edits an agent file
|
||||
vim .opencode/agent/core/openagent.md
|
||||
# OAC updates
|
||||
oac update
|
||||
# Expected: edited file is SKIPPED, everything else updates
|
||||
# Expected: clear message about what was skipped and why
|
||||
```
|
||||
|
||||
### User Test 3: Add Context for a Specific Stack
|
||||
```bash
|
||||
oac add context:react-patterns
|
||||
oac add context:typescript-patterns
|
||||
oac list --context
|
||||
# Expected: both files installed, listed correctly
|
||||
```
|
||||
|
||||
### User Test 4: Multi-IDE Setup
|
||||
```bash
|
||||
oac apply cursor
|
||||
oac apply claude
|
||||
# Expected: .cursorrules and CLAUDE.md generated
|
||||
# Expected: warnings about unsupported features
|
||||
```
|
||||
|
||||
### User Test 5: Something Goes Wrong
|
||||
```bash
|
||||
rm .oac/manifest.json
|
||||
oac doctor
|
||||
# Expected: "manifest.json missing — run 'oac init' to repair"
|
||||
oac init
|
||||
# Expected: re-initializes without duplicating files
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
**Build 5 commands. Ship in 6 weeks. Make the content excellent.**
|
||||
|
||||
The CLI is a delivery truck for great AI agents and context files. The update system that respects user changes is the killer feature. Everything else can wait until users tell us what they need.
|
||||
|
||||
```
|
||||
oac init → Get set up
|
||||
oac update → Stay current
|
||||
oac add → Get what you need
|
||||
oac apply → Work in any IDE
|
||||
oac doctor → Fix problems
|
||||
```
|
||||
|
||||
That's the MVP. That's the 20% that delivers 80% of the value.
|
||||
12
install.sh
12
install.sh
|
|
@ -330,9 +330,19 @@ resolve_component_path() {
|
|||
# Helper function to get the correct registry key for a component type
|
||||
get_registry_key() {
|
||||
local type=$1
|
||||
# Most types are pluralized, but 'config' stays singular
|
||||
# Handle both singular and plural forms
|
||||
# Registry uses plural keys: agents, contexts, skills
|
||||
case "$type" in
|
||||
config) echo "config" ;;
|
||||
# Already plural forms - use as-is
|
||||
agents|contexts|skills) echo "$type" ;;
|
||||
# Singular forms - pluralize them
|
||||
agent) echo "agents" ;;
|
||||
context) echo "contexts" ;;
|
||||
skill) echo "skills" ;;
|
||||
# Fallback: if already ends with 's', assume plural
|
||||
*s) echo "$type" ;;
|
||||
# Default: add 's' to make plural
|
||||
*) echo "${type}s" ;;
|
||||
esac
|
||||
}
|
||||
|
|
|
|||
6065
package-lock.json
generated
6065
package-lock.json
generated
File diff suppressed because it is too large
Load diff
|
|
@ -3,7 +3,9 @@
|
|||
"version": "0.7.1",
|
||||
"description": "AI agent framework for plan-first development workflows with approval-based execution. Multi-language support for TypeScript, Python, Go, Rust and more.",
|
||||
"workspaces": [
|
||||
"evals/framework"
|
||||
"evals/framework",
|
||||
"packages/cli",
|
||||
"packages/compatibility-layer"
|
||||
],
|
||||
"bin": {
|
||||
"oac": "./bin/oac.js"
|
||||
|
|
@ -31,10 +33,11 @@
|
|||
"LICENSE",
|
||||
"README.md",
|
||||
"CHANGELOG.md",
|
||||
"CONTEXT_SYSTEM_GUIDE.md"
|
||||
"CONTEXT_SYSTEM_GUIDE.md",
|
||||
"packages/cli/dist/"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=14.0.0"
|
||||
"node": ">=18.0.0"
|
||||
},
|
||||
"scripts": {
|
||||
"test": "npm run test:all",
|
||||
|
|
|
|||
37
packages/cli/package.json
Normal file
37
packages/cli/package.json
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
{
|
||||
"name": "@nextsystems/oac-cli",
|
||||
"version": "1.0.0",
|
||||
"description": "OAC CLI — install, manage, and update AI agents and context files",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
"oac": "./dist/index.js"
|
||||
},
|
||||
"main": "./dist/index.js",
|
||||
"types": "./dist/index.d.ts",
|
||||
"files": ["dist"],
|
||||
"scripts": {
|
||||
"build": "rm -rf dist && bun build src/index.ts --outdir dist --target bun --splitting",
|
||||
"build:watch": "bun build src/index.ts --outdir dist --target bun --splitting --watch",
|
||||
"dev": "bun run src/index.ts",
|
||||
"test": "bun test",
|
||||
"test:watch": "bun test --watch",
|
||||
"typecheck": "tsc --noEmit"
|
||||
},
|
||||
"dependencies": {
|
||||
"@openagents-control/compatibility-layer": "*",
|
||||
"commander": "^12.0.0",
|
||||
"chalk": "^5.3.0",
|
||||
"ora": "^8.0.0",
|
||||
"semver": "^7.6.0",
|
||||
"zod": "^3.23.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/bun": "latest",
|
||||
"@types/node": "^20.0.0",
|
||||
"@types/semver": "^7.5.0",
|
||||
"typescript": "^5.4.0"
|
||||
},
|
||||
"engines": {
|
||||
"bun": ">=1.0.0"
|
||||
}
|
||||
}
|
||||
306
packages/cli/src/commands/add.ts
Normal file
306
packages/cli/src/commands/add.ts
Normal file
|
|
@ -0,0 +1,306 @@
|
|||
import path from 'node:path';
|
||||
// node:fs/promises rm is used intentionally — Bun has no built-in recursive directory removal
|
||||
import { rm } from 'node:fs/promises';
|
||||
import { type Command } from 'commander';
|
||||
import { loadRegistry, resolveComponent, listComponents } from '../lib/registry.js';
|
||||
import { getPackageRoot, getBundledFilePath } from '../lib/bundled.js';
|
||||
import { installFile } from '../lib/installer.js';
|
||||
import {
|
||||
readManifest,
|
||||
writeManifest,
|
||||
addFileToManifest,
|
||||
removeFileFromManifest,
|
||||
createEmptyManifest,
|
||||
type ManifestFile,
|
||||
type FileEntry,
|
||||
} from '../lib/manifest.js';
|
||||
import { log, info, warn, error, success, verbose } from '../ui/logger.js';
|
||||
import { createSpinner } from '../ui/spinner.js';
|
||||
import { computeFileHash } from '../lib/sha256.js';
|
||||
import { readCliVersion } from '../lib/version.js';
|
||||
import type { RegistryComponent } from '../lib/registry.js';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type AddOptions = {
|
||||
yolo: boolean;
|
||||
dryRun: boolean;
|
||||
verbose: boolean;
|
||||
force: boolean;
|
||||
};
|
||||
|
||||
export type RemoveOptions = {
|
||||
yolo: boolean;
|
||||
dryRun: boolean;
|
||||
verbose: boolean;
|
||||
};
|
||||
|
||||
// ── Pure helpers ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Returns the destination path (relative to project root) for a component.
|
||||
* Uses component.path directly if it already starts with .opencode/,
|
||||
* otherwise prefixes with the correct subdirectory. */
|
||||
const getDestRelativePath = (component: RegistryComponent): string => {
|
||||
if (component.path.startsWith('.opencode/')) return component.path;
|
||||
const base = component.type === 'skill' ? '.opencode/skills' :
|
||||
component.type === 'agent' ? '.opencode/agent' :
|
||||
'.opencode/context';
|
||||
return path.join(base, component.path);
|
||||
};
|
||||
|
||||
/** Builds a FileEntry for a newly installed component. */
|
||||
const buildFileEntry = (
|
||||
sha256: string,
|
||||
component: RegistryComponent,
|
||||
): FileEntry => ({
|
||||
sha256,
|
||||
type: component.type,
|
||||
source: 'registry',
|
||||
installedAt: new Date().toISOString(),
|
||||
});
|
||||
|
||||
/** Returns true if the file at destPath is already tracked in the manifest. */
|
||||
const isAlreadyInstalled = (
|
||||
manifest: ManifestFile | null,
|
||||
destRelativePath: string,
|
||||
): boolean => manifest?.files[destRelativePath] !== undefined;
|
||||
|
||||
// ── List display ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Prints all available components grouped by type. */
|
||||
const printAvailableComponents = async (_projectRoot: string): Promise<void> => {
|
||||
const packageRoot = getPackageRoot();
|
||||
const registry = await loadRegistry(packageRoot);
|
||||
const all = listComponents(registry);
|
||||
|
||||
const byType = {
|
||||
agent: all.filter((c) => c.type === 'agent'),
|
||||
context: all.filter((c) => c.type === 'context'),
|
||||
skill: all.filter((c) => c.type === 'skill'),
|
||||
};
|
||||
|
||||
log('');
|
||||
log('Available components:');
|
||||
log('');
|
||||
|
||||
for (const [type, components] of Object.entries(byType)) {
|
||||
if (components.length === 0) continue;
|
||||
log(` ${type.toUpperCase()}S`);
|
||||
for (const c of components) {
|
||||
log(` oac add ${type}:${c.id} — ${c.description}`);
|
||||
}
|
||||
log('');
|
||||
}
|
||||
|
||||
log(`Run 'oac add <type>:<name>' to install a component.`);
|
||||
log(`Example: oac add context:react-patterns`);
|
||||
};
|
||||
|
||||
// ── Core install logic ────────────────────────────────────────────────────────
|
||||
|
||||
/** Resolves the component from the registry or exits with a clear error. */
|
||||
const resolveOrFail = async (
|
||||
ref: string,
|
||||
): Promise<{ component: RegistryComponent; packageRoot: string }> => {
|
||||
const packageRoot = getPackageRoot();
|
||||
const registry = await loadRegistry(packageRoot);
|
||||
const component = resolveComponent(registry, ref);
|
||||
|
||||
if (component === null) {
|
||||
error(`Component '${ref}' not found. Run 'oac add' to see available components.`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
return { component, packageRoot };
|
||||
};
|
||||
|
||||
/** Checks if the component is already installed and handles --force / warning. */
|
||||
const checkAlreadyInstalled = (
|
||||
manifest: ManifestFile | null,
|
||||
destRelativePath: string,
|
||||
force: boolean,
|
||||
): boolean => {
|
||||
if (!isAlreadyInstalled(manifest, destRelativePath)) return false;
|
||||
|
||||
if (!force) {
|
||||
warn(`Already installed. Use --force to reinstall.`);
|
||||
return true; // signal: abort
|
||||
}
|
||||
|
||||
info('Reinstalling (--force).');
|
||||
return false; // signal: proceed
|
||||
};
|
||||
|
||||
/** Performs the actual file copy and manifest update. */
|
||||
const performInstall = async (
|
||||
component: RegistryComponent,
|
||||
packageRoot: string,
|
||||
projectRoot: string,
|
||||
destRelativePath: string,
|
||||
manifest: ManifestFile,
|
||||
opts: AddOptions,
|
||||
): Promise<void> => {
|
||||
const sourcePath = getBundledFilePath(packageRoot, component.path);
|
||||
const destPath = path.join(projectRoot, destRelativePath);
|
||||
const destDir = path.dirname(destRelativePath);
|
||||
|
||||
info(`Installing ${component.type}:${component.id} → ${destDir}/`);
|
||||
|
||||
if (opts.verbose) {
|
||||
verbose(`Source: ${sourcePath}`);
|
||||
verbose(`Destination: ${destPath}`);
|
||||
}
|
||||
|
||||
const installOpts = {
|
||||
projectRoot,
|
||||
packageRoot,
|
||||
dryRun: opts.dryRun,
|
||||
yolo: opts.yolo,
|
||||
verbose: opts.verbose,
|
||||
};
|
||||
|
||||
await installFile(sourcePath, destPath, installOpts);
|
||||
|
||||
if (opts.dryRun) {
|
||||
info(`[dry-run] Would install ${component.type}:${component.id} to ${destDir}/`);
|
||||
return;
|
||||
}
|
||||
|
||||
const sha256 = await computeFileHash(destPath);
|
||||
const entry = buildFileEntry(sha256, component);
|
||||
const updatedManifest = addFileToManifest(manifest, destRelativePath, entry);
|
||||
await writeManifest(projectRoot, updatedManifest);
|
||||
|
||||
success(`Added ${component.id} to ${destDir}/`);
|
||||
};
|
||||
|
||||
// ── Public command functions ──────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Implements `oac add [ref]`.
|
||||
* With no ref: lists available components grouped by type.
|
||||
* With ref (e.g. `context:react-patterns`): installs the component.
|
||||
*/
|
||||
export async function addCommand(
|
||||
ref: string | undefined,
|
||||
options: AddOptions,
|
||||
): Promise<void> {
|
||||
const projectRoot = process.cwd();
|
||||
|
||||
if (ref === undefined) {
|
||||
await printAvailableComponents(projectRoot);
|
||||
return;
|
||||
}
|
||||
|
||||
const spinner = createSpinner(`Resolving ${ref}…`, { dryRun: options.dryRun });
|
||||
spinner.start();
|
||||
|
||||
try {
|
||||
const { component, packageRoot } = await resolveOrFail(ref);
|
||||
spinner.stop();
|
||||
|
||||
const manifest = (await readManifest(projectRoot)) ?? createEmptyManifest(readCliVersion());
|
||||
const destRelativePath = getDestRelativePath(component);
|
||||
|
||||
const shouldAbort = checkAlreadyInstalled(manifest, destRelativePath, options.force);
|
||||
if (shouldAbort) return;
|
||||
|
||||
await performInstall(component, packageRoot, projectRoot, destRelativePath, manifest, options);
|
||||
} catch (err: unknown) {
|
||||
spinner.fail();
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Failed to add '${ref}': ${msg}`);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements `oac remove [ref]`.
|
||||
* Removes the component file from disk and updates the manifest.
|
||||
*/
|
||||
export async function removeCommand(
|
||||
ref: string | undefined,
|
||||
options: RemoveOptions,
|
||||
): Promise<void> {
|
||||
const projectRoot = process.cwd();
|
||||
|
||||
if (ref === undefined) {
|
||||
error('Please specify a component to remove. Example: oac remove context:react-patterns');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const spinner = createSpinner(`Resolving ${ref}…`, { dryRun: options.dryRun });
|
||||
spinner.start();
|
||||
|
||||
try {
|
||||
const { component } = await resolveOrFail(ref);
|
||||
spinner.stop();
|
||||
|
||||
const manifest = await readManifest(projectRoot);
|
||||
const destRelativePath = getDestRelativePath(component);
|
||||
|
||||
if (!isAlreadyInstalled(manifest, destRelativePath)) {
|
||||
warn(`'${ref}' is not installed — nothing to remove.`);
|
||||
return;
|
||||
}
|
||||
|
||||
const destPath = path.join(projectRoot, destRelativePath);
|
||||
|
||||
if (options.verbose) {
|
||||
verbose(`Removing: ${destPath}`);
|
||||
}
|
||||
|
||||
info(`Removing ${component.type}:${component.id} from ${path.dirname(destRelativePath)}/`);
|
||||
|
||||
if (!options.dryRun) {
|
||||
await rm(destPath, { recursive: true, force: true });
|
||||
const updatedManifest = removeFileFromManifest(manifest!, destRelativePath);
|
||||
await writeManifest(projectRoot, updatedManifest);
|
||||
success(`Removed ${component.id}`);
|
||||
} else {
|
||||
info(`[dry-run] Would remove ${destPath}`);
|
||||
}
|
||||
} catch (err: unknown) {
|
||||
spinner.fail();
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Failed to remove '${ref}': ${msg}`);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
// ── Commander registration ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `add` and `remove` subcommands on the given Commander program.
|
||||
*/
|
||||
export function registerAddCommand(program: Command): void {
|
||||
program
|
||||
.command('add [ref]')
|
||||
.description('Add a component (agent, context, or skill). Example: oac add context:react-patterns')
|
||||
.option('--force', 'Reinstall even if already installed', false)
|
||||
.option('--dry-run', 'Show what would happen without making changes', false)
|
||||
.option('--yolo', 'Skip safety checks and overwrite user-modified files', false)
|
||||
.option('--verbose', 'Show source and destination paths', false)
|
||||
.action(async (ref: string | undefined, opts: { force?: boolean; dryRun?: boolean; yolo?: boolean; verbose?: boolean }) => {
|
||||
await addCommand(ref, {
|
||||
force: opts.force ?? false,
|
||||
dryRun: opts.dryRun ?? false,
|
||||
yolo: opts.yolo ?? false,
|
||||
verbose: opts.verbose ?? false,
|
||||
});
|
||||
});
|
||||
|
||||
program
|
||||
.command('remove [ref]')
|
||||
.description('Remove an installed component. Example: oac remove context:react-patterns')
|
||||
.option('--dry-run', 'Show what would happen without making changes', false)
|
||||
.option('--yolo', 'Skip safety checks', false)
|
||||
.option('--verbose', 'Show file paths', false)
|
||||
.action(async (ref: string | undefined, opts: { dryRun?: boolean; yolo?: boolean; verbose?: boolean }) => {
|
||||
await removeCommand(ref, {
|
||||
dryRun: opts.dryRun ?? false,
|
||||
yolo: opts.yolo ?? false,
|
||||
verbose: opts.verbose ?? false,
|
||||
});
|
||||
});
|
||||
}
|
||||
334
packages/cli/src/commands/apply.ts
Normal file
334
packages/cli/src/commands/apply.ts
Normal file
|
|
@ -0,0 +1,334 @@
|
|||
/**
|
||||
* oac apply — Generate IDE-specific config files from .opencode/agent/ definitions.
|
||||
*
|
||||
* Usage:
|
||||
* oac apply cursor → writes .cursorrules
|
||||
* oac apply claude → writes CLAUDE.md
|
||||
* oac apply windsurf → writes .windsurfrules
|
||||
* oac apply --all → detects present IDEs and generates for each
|
||||
*/
|
||||
|
||||
import type { Command } from 'commander'
|
||||
import { join } from 'node:path'
|
||||
import { stat } from 'node:fs/promises'
|
||||
import {
|
||||
loadAgents,
|
||||
CursorAdapter,
|
||||
ClaudeAdapter,
|
||||
WindsurfAdapter,
|
||||
} from '@openagents-control/compatibility-layer'
|
||||
import type { OpenAgent, ConversionResult } from '@openagents-control/compatibility-layer'
|
||||
import {
|
||||
detectIdes,
|
||||
getIdeOutputFile,
|
||||
getIdeDisplayName,
|
||||
} from '../lib/ide-detect.js'
|
||||
import type { IdeType } from '../lib/ide-detect.js'
|
||||
import { log, info, warn, error, success, dim, verbose, setVerbose } from '../ui/logger.js'
|
||||
import { createSpinner } from '../ui/spinner.js'
|
||||
|
||||
// ─── Constants ────────────────────────────────────────────────────────────────
|
||||
|
||||
/** File size thresholds in bytes. */
|
||||
const SIZE_LIMITS: Partial<Record<IdeType, { warn: number; limit: number }>> = {
|
||||
cursor: { warn: 80 * 1024, limit: 100 * 1024 },
|
||||
}
|
||||
|
||||
/** Supported apply targets (opencode is read-only source, not a write target). */
|
||||
const APPLY_TARGETS: IdeType[] = ['cursor', 'claude', 'windsurf']
|
||||
|
||||
// ─── Adapter factory ──────────────────────────────────────────────────────────
|
||||
|
||||
/** Returns the correct adapter instance for a given IDE type. */
|
||||
function getAdapter(ide: IdeType): CursorAdapter | ClaudeAdapter | WindsurfAdapter | null {
|
||||
if (ide === 'cursor') return new CursorAdapter()
|
||||
if (ide === 'claude') return new ClaudeAdapter()
|
||||
if (ide === 'windsurf') return new WindsurfAdapter()
|
||||
return null
|
||||
}
|
||||
|
||||
// ─── Size helpers ─────────────────────────────────────────────────────────────
|
||||
|
||||
/** Format bytes as a human-readable KB string. */
|
||||
function formatKb(bytes: number): string {
|
||||
return `${(bytes / 1024).toFixed(0)}KB`
|
||||
}
|
||||
|
||||
/** Print size info and warn if thresholds are exceeded. */
|
||||
function reportFileSize(ide: IdeType, outputPath: string, sizeBytes: number): void {
|
||||
const displayName = getIdeDisplayName(ide)
|
||||
const outputRelPath = getIdeOutputFile(ide)
|
||||
const limits = SIZE_LIMITS[ide]
|
||||
|
||||
dim(` ${displayName}: ${outputPath} is ${formatKb(sizeBytes)}`)
|
||||
|
||||
if (limits && sizeBytes >= limits.limit) {
|
||||
warn(`${displayName}: ${outputRelPath} is ${formatKb(sizeBytes)} — over the ${formatKb(limits.limit)} limit, consider removing agents`)
|
||||
} else if (limits && sizeBytes >= limits.warn) {
|
||||
warn(`${displayName}: ${outputRelPath} is ${formatKb(sizeBytes)} — approaching the ${formatKb(limits.limit)} limit`)
|
||||
}
|
||||
}
|
||||
|
||||
// ─── Backup helper ────────────────────────────────────────────────────────────
|
||||
|
||||
/** Backs up an existing file to `{file}.bak` before overwriting. */
|
||||
async function backupIfExists(filePath: string): Promise<void> {
|
||||
if (await Bun.file(filePath).exists()) {
|
||||
const backupPath = `${filePath}.bak`
|
||||
await Bun.write(backupPath, Bun.file(filePath))
|
||||
dim(` Backed up existing file → ${backupPath}`)
|
||||
}
|
||||
}
|
||||
|
||||
// ─── Dry-run preview ──────────────────────────────────────────────────────────
|
||||
|
||||
/** Prints a dry-run preview of what would be written. */
|
||||
function printDryRunPreview(outputPath: string, content: string): void {
|
||||
info(`[dry-run] Would write: ${outputPath} (${formatKb(Buffer.byteLength(content, 'utf-8'))})`)
|
||||
dim('─'.repeat(60))
|
||||
// Show first 10 lines as a preview
|
||||
const preview = content.split('\n').slice(0, 10).join('\n')
|
||||
dim(preview)
|
||||
if (content.split('\n').length > 10) {
|
||||
dim(` … (${content.split('\n').length - 10} more lines)`)
|
||||
}
|
||||
dim('─'.repeat(60))
|
||||
}
|
||||
|
||||
// ─── Conversion warnings ──────────────────────────────────────────────────────
|
||||
|
||||
/** Prints adapter warnings to the user. */
|
||||
function reportWarnings(result: ConversionResult, isVerbose: boolean): void {
|
||||
if (!result.warnings || result.warnings.length === 0) return
|
||||
|
||||
if (isVerbose) {
|
||||
result.warnings.forEach((w: string) => warn(w))
|
||||
return
|
||||
}
|
||||
warn(`${result.warnings.length} conversion warning(s) — use --verbose to see details`)
|
||||
}
|
||||
|
||||
// ─── Single IDE apply ─────────────────────────────────────────────────────────
|
||||
|
||||
/** Applies agents to a single IDE target. Returns true on success. */
|
||||
async function applyToIde(
|
||||
ide: IdeType,
|
||||
agents: OpenAgent[],
|
||||
projectRoot: string,
|
||||
options: { dryRun: boolean; verbose: boolean }
|
||||
): Promise<boolean> {
|
||||
const displayName = getIdeDisplayName(ide)
|
||||
const outputRelPath = getIdeOutputFile(ide)
|
||||
const outputPath = join(projectRoot, outputRelPath)
|
||||
const adapter = getAdapter(ide)
|
||||
|
||||
if (!adapter) {
|
||||
error(`No adapter available for IDE: ${ide}`)
|
||||
return false
|
||||
}
|
||||
|
||||
if (agents.length === 0) {
|
||||
warn(`No agents found in .opencode/agent/ — nothing to apply for ${displayName}`)
|
||||
return false
|
||||
}
|
||||
|
||||
const spinner = createSpinner(`Generating ${outputRelPath} for ${displayName}…`, {
|
||||
dryRun: options.dryRun,
|
||||
})
|
||||
spinner.start()
|
||||
|
||||
try {
|
||||
// Cursor merges all agents into one; others process the first/primary agent
|
||||
const result: ConversionResult = ide === 'cursor'
|
||||
? await (adapter as CursorAdapter).fromOAC((adapter as CursorAdapter).mergeAgents(agents))
|
||||
// For Claude and Windsurf, use the first (primary) agent — multiple agents are not merged
|
||||
: await adapter.fromOAC(agents[0]!)
|
||||
|
||||
if (!result.success || result.configs.length === 0) {
|
||||
spinner.fail(`Failed to generate ${outputRelPath}`)
|
||||
const errs = result.errors ?? ['Unknown conversion error']
|
||||
errs.forEach((e: string) => error(e))
|
||||
return false
|
||||
}
|
||||
|
||||
// Concatenate all config content (most adapters return one config)
|
||||
const content = result.configs.map((c: { content: string }) => c.content).join('\n')
|
||||
const sizeBytes = Buffer.byteLength(content, 'utf-8')
|
||||
|
||||
spinner.stop()
|
||||
|
||||
if (options.dryRun) {
|
||||
printDryRunPreview(outputPath, content)
|
||||
} else {
|
||||
await backupIfExists(outputPath)
|
||||
await Bun.write(outputPath, content)
|
||||
}
|
||||
|
||||
reportWarnings(result, options.verbose)
|
||||
|
||||
const label = options.dryRun ? '[dry-run] Would write' : 'Wrote'
|
||||
success(`${label}: ${outputRelPath} (${formatKb(sizeBytes)})`)
|
||||
|
||||
if (!options.dryRun) {
|
||||
const fileStat = await stat(outputPath)
|
||||
reportFileSize(ide, outputPath, fileStat.size)
|
||||
} else {
|
||||
reportFileSize(ide, outputPath, sizeBytes)
|
||||
}
|
||||
|
||||
return true
|
||||
} catch (err) {
|
||||
spinner.fail(`Error generating ${outputRelPath}`)
|
||||
error(`${displayName} adapter failed: ${err instanceof Error ? err.message : String(err)}`)
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
// ─── Resolve target IDEs ──────────────────────────────────────────────────────
|
||||
|
||||
/** Resolves which IDE targets to apply based on CLI args and --all flag. */
|
||||
async function resolveTargets(
|
||||
ide: string | undefined,
|
||||
all: boolean,
|
||||
projectRoot: string
|
||||
): Promise<IdeType[]> {
|
||||
if (all) {
|
||||
const detected = await detectIdes(projectRoot)
|
||||
const present = detected
|
||||
.filter((d) => d.detected && APPLY_TARGETS.includes(d.type))
|
||||
.map((d) => d.type)
|
||||
|
||||
if (present.length === 0) {
|
||||
warn('No supported IDEs detected. Install Cursor, Claude, or Windsurf first.')
|
||||
info('Tip: Run `oac apply cursor` to generate .cursorrules regardless.')
|
||||
} else {
|
||||
info(`Detected IDEs: ${present.map(getIdeDisplayName).join(', ')}`)
|
||||
}
|
||||
|
||||
return present
|
||||
}
|
||||
|
||||
if (!ide) {
|
||||
error('Specify an IDE target: cursor | claude | windsurf, or use --all')
|
||||
return []
|
||||
}
|
||||
|
||||
if (!APPLY_TARGETS.includes(ide as IdeType)) {
|
||||
error(`Unknown IDE: "${ide}". Valid targets: ${APPLY_TARGETS.join(', ')}`)
|
||||
return []
|
||||
}
|
||||
|
||||
return [ide as IdeType]
|
||||
}
|
||||
|
||||
// ─── Main command function ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Core logic for `oac apply`.
|
||||
*
|
||||
* @param ide - Optional IDE target (cursor | claude | windsurf)
|
||||
* @param options - CLI flags
|
||||
*/
|
||||
export async function applyCommand(
|
||||
ide: string | undefined,
|
||||
options: { yolo: boolean; dryRun: boolean; verbose: boolean; all: boolean }
|
||||
): Promise<void> {
|
||||
const projectRoot = process.cwd()
|
||||
const agentDir = join(projectRoot, '.opencode', 'agent')
|
||||
|
||||
// Sync verbose flag with logger module so verbose() calls work
|
||||
setVerbose(options.verbose)
|
||||
|
||||
if (options.dryRun) {
|
||||
info('Dry-run mode — no files will be written')
|
||||
}
|
||||
|
||||
// Resolve which IDEs to target
|
||||
const targets = await resolveTargets(ide, options.all, projectRoot)
|
||||
if (targets.length === 0) {
|
||||
process.exitCode = 1
|
||||
return
|
||||
}
|
||||
|
||||
// Load agents once — shared across all targets
|
||||
verbose(`Loading agents from ${agentDir}`)
|
||||
const agentDirExists = await stat(agentDir).then((s) => s.isDirectory()).catch(() => false)
|
||||
if (!agentDirExists) {
|
||||
error(`Agent directory not found: ${agentDir}`)
|
||||
error('Run `oac init` first to set up your project.')
|
||||
process.exitCode = 1
|
||||
return
|
||||
}
|
||||
|
||||
let agents: OpenAgent[]
|
||||
try {
|
||||
agents = await loadAgents(agentDir)
|
||||
verbose(`Loaded ${agents.length} agent(s)`)
|
||||
} catch (err) {
|
||||
error(`Failed to load agents from ${agentDir}: ${err instanceof Error ? err.message : String(err)}`)
|
||||
process.exitCode = 1
|
||||
return
|
||||
}
|
||||
|
||||
if (agents.length === 0) {
|
||||
warn(`No agents found in ${agentDir}`)
|
||||
info('Add agent files (*.md) to .opencode/agent/ and try again.')
|
||||
process.exitCode = 1
|
||||
return
|
||||
}
|
||||
|
||||
log('')
|
||||
info(`Applying ${agents.length} agent(s) to: ${targets.map(getIdeDisplayName).join(', ')}`)
|
||||
log('')
|
||||
|
||||
// Apply to each target
|
||||
let allSucceeded = true
|
||||
for (const target of targets) {
|
||||
const ok = await applyToIde(target, agents, projectRoot, {
|
||||
dryRun: options.dryRun,
|
||||
verbose: options.verbose,
|
||||
})
|
||||
if (!ok) allSucceeded = false
|
||||
log('')
|
||||
}
|
||||
|
||||
if (!allSucceeded) {
|
||||
process.exitCode = 1
|
||||
}
|
||||
}
|
||||
|
||||
// ─── Commander registration ───────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `oac apply [ide]` command with the Commander program.
|
||||
*
|
||||
* @param program - The root Commander instance
|
||||
*/
|
||||
export function registerApplyCommand(program: Command): void {
|
||||
program
|
||||
.command('apply [ide]')
|
||||
.description('Generate IDE config files from .opencode/agent/ definitions')
|
||||
.option('--all', 'Apply to all detected IDEs', false)
|
||||
.option('--dry-run', 'Show what would be generated without writing', false)
|
||||
.option('--verbose', 'Show adapter warnings and transformation details', false)
|
||||
.option('--yolo', 'Skip confirmation prompts', false)
|
||||
.addHelpText(
|
||||
'after',
|
||||
`
|
||||
Examples:
|
||||
oac apply cursor Generate .cursorrules
|
||||
oac apply claude Generate CLAUDE.md
|
||||
oac apply windsurf Generate .windsurfrules
|
||||
oac apply --all Generate for all detected IDEs
|
||||
oac apply cursor --dry-run Preview without writing
|
||||
`
|
||||
)
|
||||
.action(async (ide: string | undefined, opts: Record<string, unknown>) => {
|
||||
await applyCommand(ide, {
|
||||
yolo: Boolean(opts['yolo']),
|
||||
dryRun: Boolean(opts['dryRun']),
|
||||
verbose: Boolean(opts['verbose']),
|
||||
all: Boolean(opts['all']),
|
||||
})
|
||||
})
|
||||
}
|
||||
403
packages/cli/src/commands/doctor.ts
Normal file
403
packages/cli/src/commands/doctor.ts
Normal file
|
|
@ -0,0 +1,403 @@
|
|||
import { join } from 'node:path';
|
||||
import { type Command } from 'commander';
|
||||
import semver from 'semver';
|
||||
|
||||
import { readCliVersion } from '../lib/version.js';
|
||||
import { readManifest } from '../lib/manifest.js';
|
||||
import { readConfig } from '../lib/config.js';
|
||||
import { computeFileHash, hashesMatch } from '../lib/sha256.js';
|
||||
import { detectIdes, getIdeDisplayName, getIdeOutputFile } from '../lib/ide-detect.js';
|
||||
import { log, info, warn, error, success, dim, bold, setVerbose } from '../ui/logger.js';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type CheckStatus = 'ok' | 'warn' | 'error' | 'info';
|
||||
|
||||
export type CheckResult = {
|
||||
name: string;
|
||||
status: CheckStatus;
|
||||
message: string;
|
||||
detail?: string[];
|
||||
};
|
||||
|
||||
export type DoctorOptions = {
|
||||
verbose: boolean;
|
||||
json: boolean;
|
||||
};
|
||||
|
||||
type DoctorSummary = {
|
||||
ok: number;
|
||||
warnings: number;
|
||||
errors: number;
|
||||
};
|
||||
|
||||
// ── Version helpers ───────────────────────────────────────────────────────────
|
||||
|
||||
/** Fetches the latest version from the npm registry. Returns null if offline. */
|
||||
const fetchLatestNpmVersion = async (packageName: string): Promise<string | null> => {
|
||||
try {
|
||||
const url = `https://registry.npmjs.org/${packageName}/latest`;
|
||||
const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
|
||||
if (!res.ok) return null;
|
||||
const data = (await res.json()) as { version?: string };
|
||||
return data.version ?? null;
|
||||
} catch {
|
||||
// Network unavailable or timeout — non-blocking
|
||||
return null;
|
||||
}
|
||||
};
|
||||
|
||||
// ── Individual check functions ────────────────────────────────────────────────
|
||||
|
||||
/** Check 1: OAC version vs npm registry (non-blocking, skipped if offline). */
|
||||
const checkOacVersion = async (): Promise<CheckResult> => {
|
||||
const current = readCliVersion();
|
||||
const latest = await fetchLatestNpmVersion('@nextsystems/oac');
|
||||
|
||||
if (latest === null) {
|
||||
return {
|
||||
name: 'OAC version',
|
||||
status: 'info',
|
||||
message: `${current} (registry check skipped — offline or unreachable)`,
|
||||
};
|
||||
}
|
||||
|
||||
const isOutdated = semver.lt(current, latest);
|
||||
if (isOutdated) {
|
||||
return {
|
||||
name: 'OAC version',
|
||||
status: 'warn',
|
||||
message: `${current} (latest: ${latest}) — run 'npm install -g @nextsystems/oac' to update`,
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
name: 'OAC version',
|
||||
status: 'ok',
|
||||
message: `${current} (latest)`,
|
||||
};
|
||||
};
|
||||
|
||||
/** Check 2: Bun runtime version >= 1.0.0. */
|
||||
const checkBunVersion = (): CheckResult => {
|
||||
const bunVersion = Bun.version; // e.g. "1.1.0" — global provided by @types/bun
|
||||
const MIN_BUN = '1.0.0';
|
||||
const isValid = semver.gte(bunVersion, MIN_BUN);
|
||||
|
||||
return {
|
||||
name: 'Bun runtime',
|
||||
status: isValid ? 'ok' : 'error',
|
||||
message: isValid
|
||||
? `${bunVersion} (>= ${MIN_BUN} required)`
|
||||
: `${bunVersion} is below minimum required ${MIN_BUN} — upgrade Bun`,
|
||||
};
|
||||
};
|
||||
|
||||
/** Check 3: .oac/config.json exists and is valid JSON. */
|
||||
const checkConfig = async (projectRoot: string): Promise<CheckResult> => {
|
||||
try {
|
||||
const config = await readConfig(projectRoot);
|
||||
if (config === null) {
|
||||
return {
|
||||
name: 'Config',
|
||||
status: 'warn',
|
||||
message: '.oac/config.json not found — run \'oac init\' to create it',
|
||||
};
|
||||
}
|
||||
return {
|
||||
name: 'Config',
|
||||
status: 'ok',
|
||||
message: '.oac/config.json valid',
|
||||
};
|
||||
} catch (err) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
return {
|
||||
name: 'Config',
|
||||
status: 'error',
|
||||
message: `.oac/config.json invalid — ${msg}`,
|
||||
};
|
||||
}
|
||||
};
|
||||
|
||||
/** Check 4: .oac/manifest.json exists and is valid JSON. */
|
||||
const checkManifest = async (projectRoot: string): Promise<CheckResult> => {
|
||||
try {
|
||||
const manifest = await readManifest(projectRoot);
|
||||
if (manifest === null) {
|
||||
return {
|
||||
name: 'Manifest',
|
||||
status: 'error',
|
||||
message: '.oac/manifest.json not found — run \'oac init\' to create it',
|
||||
};
|
||||
}
|
||||
const fileCount = Object.keys(manifest.files).length;
|
||||
return {
|
||||
name: 'Manifest',
|
||||
status: 'ok',
|
||||
message: `.oac/manifest.json valid (${fileCount} file${fileCount !== 1 ? 's' : ''} tracked)`,
|
||||
};
|
||||
} catch (err) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
return {
|
||||
name: 'Manifest',
|
||||
status: 'error',
|
||||
message: `.oac/manifest.json invalid — ${msg}`,
|
||||
};
|
||||
}
|
||||
};
|
||||
|
||||
/** Check 5: Every file listed in manifest exists on disk. */
|
||||
const checkFilesOnDisk = async (projectRoot: string): Promise<CheckResult> => {
|
||||
const manifest = await readManifest(projectRoot);
|
||||
if (manifest === null) {
|
||||
return {
|
||||
name: 'Files on disk',
|
||||
status: 'error',
|
||||
message: 'Cannot check files — manifest is missing',
|
||||
};
|
||||
}
|
||||
|
||||
const trackedFiles = Object.keys(manifest.files);
|
||||
if (trackedFiles.length === 0) {
|
||||
return {
|
||||
name: 'Files on disk',
|
||||
status: 'ok',
|
||||
message: 'No files tracked in manifest',
|
||||
};
|
||||
}
|
||||
|
||||
const missingFiles: string[] = [];
|
||||
for (const filePath of trackedFiles) {
|
||||
const absPath = join(projectRoot, filePath);
|
||||
const exists = await Bun.file(absPath).exists();
|
||||
if (!exists) missingFiles.push(filePath);
|
||||
}
|
||||
|
||||
if (missingFiles.length > 0) {
|
||||
return {
|
||||
name: 'Files on disk',
|
||||
status: 'error',
|
||||
message: `${missingFiles.length} file${missingFiles.length !== 1 ? 's' : ''} missing from disk`,
|
||||
detail: missingFiles,
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
name: 'Files on disk',
|
||||
status: 'ok',
|
||||
message: `All ${trackedFiles.length} tracked file${trackedFiles.length !== 1 ? 's' : ''} present`,
|
||||
};
|
||||
};
|
||||
|
||||
/** Check 6: SHA256 mismatch detection — warn for user-modified files. */
|
||||
const checkModifiedFiles = async (projectRoot: string): Promise<CheckResult> => {
|
||||
const manifest = await readManifest(projectRoot);
|
||||
if (manifest === null) {
|
||||
return {
|
||||
name: 'Modified files',
|
||||
status: 'error',
|
||||
message: 'Cannot check modifications — manifest is missing',
|
||||
};
|
||||
}
|
||||
|
||||
const trackedFiles = Object.keys(manifest.files);
|
||||
if (trackedFiles.length === 0) {
|
||||
return {
|
||||
name: 'Modified files',
|
||||
status: 'ok',
|
||||
message: 'No files tracked',
|
||||
};
|
||||
}
|
||||
|
||||
const modifiedFiles: string[] = [];
|
||||
for (const filePath of trackedFiles) {
|
||||
const absPath = join(projectRoot, filePath);
|
||||
const exists = await Bun.file(absPath).exists();
|
||||
if (!exists) continue; // Already reported by checkFilesOnDisk
|
||||
|
||||
try {
|
||||
const currentHash = await computeFileHash(absPath);
|
||||
const manifestHash = manifest.files[filePath]!.sha256;
|
||||
if (!hashesMatch(currentHash, manifestHash)) {
|
||||
modifiedFiles.push(filePath);
|
||||
}
|
||||
} catch {
|
||||
// If we can't hash it, skip — checkFilesOnDisk will catch missing files
|
||||
}
|
||||
}
|
||||
|
||||
if (modifiedFiles.length > 0) {
|
||||
return {
|
||||
name: 'Modified files',
|
||||
status: 'warn',
|
||||
message: `${modifiedFiles.length} file${modifiedFiles.length !== 1 ? 's' : ''} modified since install`,
|
||||
detail: modifiedFiles,
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
name: 'Modified files',
|
||||
status: 'ok',
|
||||
message: 'No files modified since install',
|
||||
};
|
||||
};
|
||||
|
||||
/** Check 7: IDE detection — suggests 'oac apply' for each detected IDE. */
|
||||
const checkIdes = async (projectRoot: string): Promise<CheckResult[]> => {
|
||||
const ides = await detectIdes(projectRoot);
|
||||
const detected = ides.filter((ide) => ide.detected);
|
||||
|
||||
if (detected.length === 0) {
|
||||
return [
|
||||
{
|
||||
name: 'IDE detection',
|
||||
status: 'info',
|
||||
message: 'No IDEs detected — run \'oac apply <ide>\' to generate IDE-specific files',
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
return detected.map((ide) => ({
|
||||
name: `IDE: ${getIdeDisplayName(ide.type)}`,
|
||||
status: 'warn' as CheckStatus,
|
||||
message: `${getIdeDisplayName(ide.type)} detected (${ide.indicator}) — run 'oac apply ${ide.type}' to sync ${getIdeOutputFile(ide.type)}`,
|
||||
}));
|
||||
};
|
||||
|
||||
// ── Result rendering ──────────────────────────────────────────────────────────
|
||||
|
||||
/** Prints a single check result with colored status indicator. */
|
||||
const printCheckResult = (result: CheckResult): void => {
|
||||
switch (result.status) {
|
||||
case 'ok':
|
||||
success(`${result.name}: ${result.message}`);
|
||||
break;
|
||||
case 'warn':
|
||||
warn(`${result.name}: ${result.message}`);
|
||||
break;
|
||||
case 'error':
|
||||
error(`${result.name}: ${result.message}`);
|
||||
break;
|
||||
case 'info':
|
||||
info(`${result.name}: ${result.message}`);
|
||||
break;
|
||||
}
|
||||
|
||||
if (result.detail && result.detail.length > 0) {
|
||||
for (const line of result.detail) {
|
||||
dim(` - ${line}`);
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
/** Computes summary counts from check results. Pure function. */
|
||||
const summariseResults = (results: CheckResult[]): DoctorSummary => ({
|
||||
ok: results.filter((r) => r.status === 'ok' || r.status === 'info').length,
|
||||
warnings: results.filter((r) => r.status === 'warn').length,
|
||||
errors: results.filter((r) => r.status === 'error').length,
|
||||
});
|
||||
|
||||
/** Returns the overall status string from a summary. Pure function. */
|
||||
const overallStatus = (summary: DoctorSummary): 'healthy' | 'warning' | 'error' => {
|
||||
if (summary.errors > 0) return 'error';
|
||||
if (summary.warnings > 0) return 'warning';
|
||||
return 'healthy';
|
||||
};
|
||||
|
||||
/** Prints the final result line. Side-effect only. */
|
||||
const printFinalResult = (summary: DoctorSummary): void => {
|
||||
log('');
|
||||
const status = overallStatus(summary);
|
||||
const parts: string[] = [];
|
||||
if (summary.warnings > 0) parts.push(`${summary.warnings} warning${summary.warnings !== 1 ? 's' : ''}`);
|
||||
if (summary.errors > 0) parts.push(`${summary.errors} error${summary.errors !== 1 ? 's' : ''}`);
|
||||
const detail = parts.length > 0 ? ` (${parts.join(', ')})` : '';
|
||||
|
||||
if (status === 'healthy') {
|
||||
success(`Result: HEALTHY${detail}`);
|
||||
} else if (status === 'warning') {
|
||||
warn(`Result: WARNING${detail}`);
|
||||
} else {
|
||||
error(`Result: UNHEALTHY${detail}`);
|
||||
}
|
||||
log('');
|
||||
};
|
||||
|
||||
// ── Main command ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Implements `oac doctor`:
|
||||
* Runs all 7 health checks, prints results, and exits with code 0 (healthy/warnings)
|
||||
* or 1 (errors found). Supports --json for machine-readable output.
|
||||
*/
|
||||
export async function doctorCommand(options: DoctorOptions): Promise<void> {
|
||||
if (options.verbose) setVerbose(true);
|
||||
|
||||
const projectRoot = process.cwd();
|
||||
|
||||
// Run all independent async checks in parallel for speed
|
||||
const [configResult, manifestResult, filesResult, modifiedResult, ideResults, versionResult] =
|
||||
await Promise.all([
|
||||
checkConfig(projectRoot),
|
||||
checkManifest(projectRoot),
|
||||
checkFilesOnDisk(projectRoot),
|
||||
checkModifiedFiles(projectRoot),
|
||||
checkIdes(projectRoot),
|
||||
checkOacVersion(),
|
||||
]);
|
||||
|
||||
const allResults: CheckResult[] = [
|
||||
checkBunVersion(), // synchronous — call directly
|
||||
configResult,
|
||||
manifestResult,
|
||||
filesResult,
|
||||
modifiedResult,
|
||||
...ideResults, // checkIdes returns CheckResult[]
|
||||
versionResult,
|
||||
];
|
||||
|
||||
const summary = summariseResults(allResults);
|
||||
const status = overallStatus(summary);
|
||||
|
||||
// JSON output mode (for CI)
|
||||
if (options.json) {
|
||||
const output = {
|
||||
status,
|
||||
checks: allResults,
|
||||
summary,
|
||||
};
|
||||
log(JSON.stringify(output, null, 2));
|
||||
process.exit(summary.errors > 0 ? 1 : 0);
|
||||
return;
|
||||
}
|
||||
|
||||
// Human-readable output
|
||||
log('');
|
||||
bold('OAC Doctor — Checking your setup...');
|
||||
log('');
|
||||
|
||||
for (const result of allResults) {
|
||||
printCheckResult(result);
|
||||
}
|
||||
|
||||
printFinalResult(summary);
|
||||
|
||||
process.exit(summary.errors > 0 ? 1 : 0);
|
||||
}
|
||||
|
||||
// ── Commander registration ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `doctor` subcommand on the given Commander program.
|
||||
* Called by the CLI entry point (index.ts).
|
||||
*/
|
||||
export function registerDoctorCommand(program: Command): void {
|
||||
program
|
||||
.command('doctor')
|
||||
.description('Check your OAC setup and report any issues')
|
||||
.option('--verbose', 'Show additional diagnostic detail', false)
|
||||
.option('--json', 'Output results as machine-readable JSON (for CI)', false)
|
||||
.action(async (opts: { verbose: boolean; json: boolean }) => {
|
||||
await doctorCommand({ verbose: opts.verbose, json: opts.json });
|
||||
});
|
||||
}
|
||||
263
packages/cli/src/commands/init.ts
Normal file
263
packages/cli/src/commands/init.ts
Normal file
|
|
@ -0,0 +1,263 @@
|
|||
import { type Command } from 'commander';
|
||||
|
||||
import { readCliVersion } from '../lib/version.js';
|
||||
import { isProjectRoot, installFiles } from '../lib/installer.js';
|
||||
import { getPackageRoot, listBundledFiles } from '../lib/bundled.js';
|
||||
import { writeManifest } from '../lib/manifest.js';
|
||||
import { readConfig, writeConfig, createDefaultConfig } from '../lib/config.js';
|
||||
import { detectIdes } from '../lib/ide-detect.js';
|
||||
import { log, info, warn, error, success, setVerbose, verbose } from '../ui/logger.js';
|
||||
import { createSpinner } from '../ui/spinner.js';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type InitOptions = {
|
||||
yolo: boolean;
|
||||
dryRun: boolean;
|
||||
verbose: boolean;
|
||||
};
|
||||
|
||||
// ── Helpers ───────────────────────────────────────────────────────────────────
|
||||
|
||||
/** Counts files by type prefix. Pure function. */
|
||||
const countByType = (
|
||||
files: string[],
|
||||
): { agents: number; context: number; skills: number; other: number } => ({
|
||||
agents: files.filter((f) => f.startsWith('.opencode/agent/')).length,
|
||||
context: files.filter((f) => f.startsWith('.opencode/context/')).length,
|
||||
skills: files.filter((f) => f.startsWith('.opencode/skills/')).length,
|
||||
other: files.filter(
|
||||
(f) =>
|
||||
!f.startsWith('.opencode/agent/') &&
|
||||
!f.startsWith('.opencode/context/') &&
|
||||
!f.startsWith('.opencode/skills/'),
|
||||
).length,
|
||||
});
|
||||
|
||||
/** Formats a file-count summary string. Pure function. */
|
||||
const formatFileSummary = (counts: ReturnType<typeof countByType>): string => {
|
||||
const parts: string[] = [];
|
||||
if (counts.agents > 0) parts.push(`${counts.agents} agent${counts.agents !== 1 ? 's' : ''}`);
|
||||
if (counts.context > 0) parts.push(`${counts.context} context file${counts.context !== 1 ? 's' : ''}`);
|
||||
if (counts.skills > 0) parts.push(`${counts.skills} skill${counts.skills !== 1 ? 's' : ''}`);
|
||||
if (counts.other > 0) parts.push(`${counts.other} other file${counts.other !== 1 ? 's' : ''}`);
|
||||
return parts.join(', ') || '0 files';
|
||||
};
|
||||
|
||||
/** Prints the pre-install plan. Side-effect only. */
|
||||
const printPlan = (
|
||||
bundledFiles: string[],
|
||||
ides: Awaited<ReturnType<typeof detectIdes>>,
|
||||
dryRun: boolean,
|
||||
): void => {
|
||||
const counts = countByType(bundledFiles);
|
||||
const detectedIdes = ides.filter((i) => i.detected).map((i) => i.type);
|
||||
|
||||
log('');
|
||||
log(dryRun ? ' [dry-run] oac init — no files will be written' : ' oac init');
|
||||
log('');
|
||||
info(`Will install: ${formatFileSummary(counts)}`);
|
||||
info(`Destination: .opencode/ (relative to project root)`);
|
||||
|
||||
if (detectedIdes.length > 0) {
|
||||
info(`IDEs detected: ${detectedIdes.join(', ')} — run \`oac apply\` after init`);
|
||||
} else {
|
||||
info('No IDEs detected — run `oac apply <ide>` to generate IDE-specific files');
|
||||
}
|
||||
|
||||
log('');
|
||||
};
|
||||
|
||||
/** Prints the post-install summary. Side-effect only. */
|
||||
const printSummary = (
|
||||
installed: number,
|
||||
skipped: number,
|
||||
errors: number,
|
||||
dryRun: boolean,
|
||||
): void => {
|
||||
log('');
|
||||
if (dryRun) {
|
||||
info(`[dry-run] Would install ${installed} file${installed !== 1 ? 's' : ''}.`);
|
||||
info('No changes were made. Remove --dry-run to apply.');
|
||||
return;
|
||||
}
|
||||
if (errors > 0) {
|
||||
warn(`Completed with ${errors} error${errors !== 1 ? 's' : ''}.`);
|
||||
}
|
||||
if (skipped > 0) {
|
||||
info(`Skipped ${skipped} file${skipped !== 1 ? 's' : ''} (already modified — use --yolo to overwrite).`);
|
||||
}
|
||||
success(
|
||||
`Done! ${installed} file${installed !== 1 ? 's' : ''} installed. Run \`oac doctor\` to verify.`,
|
||||
);
|
||||
log('');
|
||||
};
|
||||
|
||||
// ── Validation ────────────────────────────────────────────────────────────────
|
||||
|
||||
/** Validates we are in a project root. Exits with code 1 if not. */
|
||||
const assertProjectRoot = async (cwd: string): Promise<void> => {
|
||||
const isRoot = await isProjectRoot(cwd);
|
||||
if (!isRoot) {
|
||||
error(
|
||||
'Not a project root — no package.json or .git found in the current directory.',
|
||||
);
|
||||
error('Fix: run `oac init` from your project root (where package.json lives).');
|
||||
process.exit(1);
|
||||
}
|
||||
};
|
||||
|
||||
// ── Config guard ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Writes the default config only if one does not already exist.
|
||||
* Idempotent — never overwrites an existing config.
|
||||
*/
|
||||
const ensureConfig = async (projectRoot: string, dryRun: boolean): Promise<void> => {
|
||||
const existing = await readConfig(projectRoot);
|
||||
if (existing !== null) {
|
||||
verbose('Config already exists — skipping config write.');
|
||||
return;
|
||||
}
|
||||
if (dryRun) {
|
||||
info('[dry-run] Would write .oac/config.json with defaults.');
|
||||
return;
|
||||
}
|
||||
await writeConfig(projectRoot, createDefaultConfig());
|
||||
verbose('Wrote .oac/config.json with defaults.');
|
||||
};
|
||||
|
||||
// ── Main command ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Implements `oac init`:
|
||||
* 1. Validates we are in a project root
|
||||
* 2. Detects IDEs and prints the install plan
|
||||
* 3. Copies all bundled files via installFiles()
|
||||
* 4. Writes .oac/manifest.json
|
||||
* 5. Writes .oac/config.json (only if absent)
|
||||
* 6. Prints a completion summary
|
||||
*/
|
||||
export async function initCommand(options: InitOptions): Promise<void> {
|
||||
// Respect CI=true as implicit --yolo
|
||||
const effectiveYolo = options.yolo || process.env['CI'] === 'true';
|
||||
const effectiveOptions = { ...options, yolo: effectiveYolo };
|
||||
|
||||
if (effectiveOptions.verbose) setVerbose(true);
|
||||
|
||||
const projectRoot = process.cwd();
|
||||
|
||||
// Step 1: validate project root
|
||||
await assertProjectRoot(projectRoot);
|
||||
|
||||
// Step 2: locate bundled files
|
||||
let packageRoot: string;
|
||||
let bundledFiles: string[];
|
||||
try {
|
||||
packageRoot = getPackageRoot();
|
||||
bundledFiles = await listBundledFiles(packageRoot);
|
||||
} catch (err) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Could not locate bundled files: ${msg}`);
|
||||
error('Fix: ensure @nextsystems/oac is installed correctly (try reinstalling).');
|
||||
process.exit(1);
|
||||
return;
|
||||
}
|
||||
|
||||
if (bundledFiles.length === 0) {
|
||||
warn('No bundled files found — nothing to install.');
|
||||
warn('Fix: the @nextsystems/oac package may be missing its bundled assets.');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Step 3: detect IDEs and print plan
|
||||
const ides = await detectIdes(projectRoot);
|
||||
printPlan(bundledFiles, ides, effectiveOptions.dryRun);
|
||||
|
||||
// Step 4: install files
|
||||
const spinner = createSpinner('Installing files…', { dryRun: effectiveOptions.dryRun });
|
||||
spinner.start();
|
||||
|
||||
let installResult: Awaited<ReturnType<typeof installFiles>>;
|
||||
try {
|
||||
installResult = await installFiles(bundledFiles, {
|
||||
projectRoot,
|
||||
packageRoot,
|
||||
dryRun: effectiveOptions.dryRun,
|
||||
yolo: effectiveOptions.yolo,
|
||||
verbose: effectiveOptions.verbose,
|
||||
});
|
||||
} catch (err) {
|
||||
spinner.fail('Installation failed.');
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Installation failed: ${msg}`);
|
||||
error('Fix: check file permissions in your project directory.');
|
||||
process.exit(1);
|
||||
return;
|
||||
}
|
||||
const { result, updatedManifest } = installResult;
|
||||
|
||||
// Report per-file errors (non-fatal — partial installs are still useful)
|
||||
for (const fileError of result.errors) {
|
||||
warn(`Error: ${fileError}`);
|
||||
}
|
||||
|
||||
spinner.succeed(`Installed ${result.installed.length} file${result.installed.length !== 1 ? 's' : ''}.`);
|
||||
|
||||
// Step 5: write manifest (skip in dry-run)
|
||||
if (effectiveOptions.dryRun) {
|
||||
info('[dry-run] Would write .oac/manifest.json');
|
||||
} else {
|
||||
const cliVersion = readCliVersion();
|
||||
const finalManifest = { ...updatedManifest, oacVersion: cliVersion };
|
||||
|
||||
await writeManifest(projectRoot, finalManifest).catch((err: unknown) => {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Failed to write manifest: ${msg}`);
|
||||
error('Fix: check write permissions for the .oac/ directory.');
|
||||
process.exit(1) as never;
|
||||
});
|
||||
verbose('Wrote .oac/manifest.json');
|
||||
}
|
||||
|
||||
// Step 6: write config (only if absent)
|
||||
await ensureConfig(projectRoot, effectiveOptions.dryRun).catch((err: unknown) => {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Failed to write config: ${msg}`);
|
||||
error('Fix: check write permissions for the .oac/ directory.');
|
||||
process.exit(1) as never;
|
||||
});
|
||||
|
||||
// Step 7: print summary
|
||||
printSummary(
|
||||
result.installed.length,
|
||||
result.skipped.length,
|
||||
result.errors.length,
|
||||
effectiveOptions.dryRun,
|
||||
);
|
||||
|
||||
// Exit 0 on success (explicit for clarity)
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// ── Commander registration ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `init` subcommand on the given Commander program.
|
||||
* Called by the CLI entry point (index.ts).
|
||||
*/
|
||||
export function registerInitCommand(program: Command): void {
|
||||
program
|
||||
.command('init')
|
||||
.description('Set up OAC agents and context files in the current project')
|
||||
.option('--yolo', 'Skip conflict checks and overwrite user-modified files', false)
|
||||
.option('--dry-run', 'Print what would happen without making any changes', false)
|
||||
.option('--verbose', 'Show each file being copied', false)
|
||||
.action(async (opts: { yolo: boolean; dryRun: boolean; verbose: boolean }) => {
|
||||
await initCommand({
|
||||
yolo: opts.yolo,
|
||||
dryRun: opts.dryRun,
|
||||
verbose: opts.verbose,
|
||||
});
|
||||
});
|
||||
}
|
||||
274
packages/cli/src/commands/list.ts
Normal file
274
packages/cli/src/commands/list.ts
Normal file
|
|
@ -0,0 +1,274 @@
|
|||
import { type Command } from 'commander';
|
||||
import path from 'node:path';
|
||||
|
||||
import { readManifest, type ManifestFile, type ManifestFileType } from '../lib/manifest.js';
|
||||
import { computeFileHash, hashesMatch } from '../lib/sha256.js';
|
||||
import { log, info, warn, bold, dim, setVerbose } from '../ui/logger.js';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type ListOptions = {
|
||||
type?: string;
|
||||
context: boolean;
|
||||
agents: boolean;
|
||||
skills: boolean;
|
||||
verbose: boolean;
|
||||
};
|
||||
|
||||
/** A single display row derived from a manifest file entry. */
|
||||
type FileRow = {
|
||||
filePath: string;
|
||||
displayPath: string;
|
||||
type: ManifestFileType;
|
||||
installedAt: string;
|
||||
sha256: string;
|
||||
userModified: boolean;
|
||||
};
|
||||
|
||||
// ── Path helpers (pure) ───────────────────────────────────────────────────────
|
||||
|
||||
/** Strips the well-known .opencode/ prefix for a cleaner display path. Pure. */
|
||||
const toDisplayPath = (filePath: string, type: ManifestFileType): string => {
|
||||
const prefixes: Record<ManifestFileType, string> = {
|
||||
agent: '.opencode/agent/',
|
||||
context: '.opencode/context/',
|
||||
skill: '.opencode/skills/',
|
||||
config: '.oac/',
|
||||
other: '',
|
||||
};
|
||||
const prefix = prefixes[type];
|
||||
return prefix && filePath.startsWith(prefix)
|
||||
? filePath.slice(prefix.length)
|
||||
: filePath;
|
||||
};
|
||||
|
||||
/** Formats an ISO timestamp as a short date string. Pure. */
|
||||
const formatDate = (iso: string): string => {
|
||||
try {
|
||||
return new Date(iso).toLocaleDateString('en-US', {
|
||||
year: 'numeric', month: 'short', day: 'numeric',
|
||||
});
|
||||
} catch {
|
||||
return iso;
|
||||
}
|
||||
};
|
||||
|
||||
// ── Grouping / filtering (pure) ───────────────────────────────────────────────
|
||||
|
||||
/** Resolves which types to display based on CLI flags. Pure. */
|
||||
const resolveActiveTypes = (options: ListOptions): ManifestFileType[] | null => {
|
||||
// --type flag takes precedence
|
||||
if (options.type) {
|
||||
const t = options.type as ManifestFileType;
|
||||
return ['agent', 'context', 'skill', 'config', 'other'].includes(t) ? [t] : null;
|
||||
}
|
||||
// Individual shorthand flags
|
||||
const selected: ManifestFileType[] = [];
|
||||
if (options.agents) selected.push('agent');
|
||||
if (options.context) selected.push('context');
|
||||
if (options.skills) selected.push('skill');
|
||||
// No flags → show all
|
||||
return selected.length > 0 ? selected : null;
|
||||
};
|
||||
|
||||
/** Groups file rows by their ManifestFileType. Pure. */
|
||||
const groupByType = (rows: FileRow[]): Map<ManifestFileType, FileRow[]> => {
|
||||
const groups = new Map<ManifestFileType, FileRow[]>();
|
||||
for (const row of rows) {
|
||||
const existing = groups.get(row.type) ?? [];
|
||||
groups.set(row.type, [...existing, row]);
|
||||
}
|
||||
return groups;
|
||||
};
|
||||
|
||||
// ── SHA256 check ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Checks whether a file on disk differs from its manifest hash. */
|
||||
const isUserModified = async (
|
||||
projectRoot: string,
|
||||
filePath: string,
|
||||
manifestHash: string,
|
||||
): Promise<boolean> => {
|
||||
try {
|
||||
const diskHash = await computeFileHash(path.join(projectRoot, filePath));
|
||||
return !hashesMatch(diskHash, manifestHash);
|
||||
} catch {
|
||||
// File missing from disk — treat as modified (doctor will catch this)
|
||||
return false;
|
||||
}
|
||||
};
|
||||
|
||||
// ── Row builder ───────────────────────────────────────────────────────────────
|
||||
|
||||
/** Builds display rows from the manifest, checking SHA256 when verbose. */
|
||||
const buildRows = async (
|
||||
manifest: ManifestFile,
|
||||
projectRoot: string,
|
||||
checkHashes: boolean,
|
||||
): Promise<FileRow[]> => {
|
||||
const entries = Object.entries(manifest.files);
|
||||
const rows = await Promise.all(
|
||||
entries.map(async ([filePath, entry]) => {
|
||||
const userModified = checkHashes
|
||||
? await isUserModified(projectRoot, filePath, entry.sha256)
|
||||
: false;
|
||||
return {
|
||||
filePath,
|
||||
displayPath: toDisplayPath(filePath, entry.type),
|
||||
type: entry.type,
|
||||
installedAt: entry.installedAt,
|
||||
sha256: entry.sha256,
|
||||
userModified,
|
||||
} satisfies FileRow;
|
||||
}),
|
||||
);
|
||||
return rows.sort((a, b) => a.displayPath.localeCompare(b.displayPath));
|
||||
};
|
||||
|
||||
// ── Rendering (side-effects only) ─────────────────────────────────────────────
|
||||
|
||||
/** Prints a single group section. */
|
||||
const printGroup = (
|
||||
label: string,
|
||||
rows: FileRow[],
|
||||
verbose: boolean,
|
||||
): void => {
|
||||
log('');
|
||||
bold(` ${label} (${rows.length}):`);
|
||||
for (const row of rows) {
|
||||
const modifiedTag = row.userModified ? ' ⚠ modified' : '';
|
||||
const line = ` ${row.displayPath}${modifiedTag}`;
|
||||
if (row.userModified) {
|
||||
warn(line.trimStart());
|
||||
} else {
|
||||
log(line);
|
||||
}
|
||||
if (verbose) {
|
||||
dim(` sha256: ${row.sha256}`);
|
||||
dim(` installedAt: ${formatDate(row.installedAt)}`);
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
/** Prints the full list output. */
|
||||
const printList = (
|
||||
groups: Map<ManifestFileType, FileRow[]>,
|
||||
activeTypes: ManifestFileType[] | null,
|
||||
verbose: boolean,
|
||||
): void => {
|
||||
const TYPE_LABELS: Record<ManifestFileType, string> = {
|
||||
agent: 'Agents',
|
||||
context: 'Context',
|
||||
skill: 'Skills',
|
||||
config: 'Config',
|
||||
other: 'Other',
|
||||
};
|
||||
// Display order
|
||||
const ORDER: ManifestFileType[] = ['agent', 'context', 'skill', 'config', 'other'];
|
||||
const typesToShow = activeTypes ?? ORDER;
|
||||
|
||||
log('');
|
||||
bold('OAC Installed Components');
|
||||
|
||||
let totalShown = 0;
|
||||
for (const type of typesToShow) {
|
||||
const rows = groups.get(type);
|
||||
if (!rows || rows.length === 0) continue;
|
||||
printGroup(TYPE_LABELS[type], rows, verbose);
|
||||
totalShown += rows.length;
|
||||
}
|
||||
|
||||
log('');
|
||||
if (totalShown === 0) {
|
||||
info('No components match the selected filter.');
|
||||
} else {
|
||||
dim(` Total: ${totalShown} file${totalShown !== 1 ? 's' : ''}`);
|
||||
}
|
||||
log('');
|
||||
};
|
||||
|
||||
// ── Main command ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Implements `oac list`:
|
||||
* 1. Reads manifest from project root
|
||||
* 2. Builds display rows (with optional SHA256 check in verbose mode)
|
||||
* 3. Groups by type and applies any active filter
|
||||
* 4. Prints human-readable output
|
||||
*
|
||||
* Always exits 0 — this is a read-only command.
|
||||
*/
|
||||
export async function listCommand(options: ListOptions): Promise<void> {
|
||||
if (options.verbose) setVerbose(true);
|
||||
|
||||
const projectRoot = process.cwd();
|
||||
|
||||
// Read manifest — null means not initialised
|
||||
let manifest: ManifestFile | null;
|
||||
try {
|
||||
manifest = await readManifest(projectRoot);
|
||||
} catch (err: unknown) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
warn(`Could not read manifest: ${msg}`);
|
||||
warn('Fix: run `oac doctor` to diagnose, or `oac init` to reset.');
|
||||
process.exit(0);
|
||||
return; // unreachable — satisfies TypeScript
|
||||
}
|
||||
|
||||
if (manifest === null) {
|
||||
log('');
|
||||
info('No components installed. Run `oac init` to get started.');
|
||||
log('');
|
||||
process.exit(0);
|
||||
return;
|
||||
}
|
||||
|
||||
if (Object.keys(manifest.files).length === 0) {
|
||||
log('');
|
||||
info('No components installed.');
|
||||
log('');
|
||||
process.exit(0);
|
||||
return;
|
||||
}
|
||||
|
||||
// Always check hashes so modified-file warnings appear; verbose adds hash/date detail
|
||||
const rows = await buildRows(manifest, projectRoot, true);
|
||||
const groups = groupByType(rows);
|
||||
const activeTypes = resolveActiveTypes(options);
|
||||
|
||||
printList(groups, activeTypes, options.verbose);
|
||||
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// ── Commander registration ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `list` subcommand on the given Commander program.
|
||||
* Called by the CLI entry point (index.ts).
|
||||
*/
|
||||
export function registerListCommand(program: Command): void {
|
||||
program
|
||||
.command('list')
|
||||
.description('Show all installed OAC components')
|
||||
.option('--type <type>', 'Filter by type: agent | context | skill | config | other')
|
||||
.option('--agents', 'Show agents only', false)
|
||||
.option('--context', 'Show context files only', false)
|
||||
.option('--skills', 'Show skills only', false)
|
||||
.option('--verbose', 'Show SHA256 hash and install date for each file', false)
|
||||
.action(async (opts: {
|
||||
type?: string;
|
||||
agents: boolean;
|
||||
context: boolean;
|
||||
skills: boolean;
|
||||
verbose: boolean;
|
||||
}) => {
|
||||
await listCommand({
|
||||
type: opts.type,
|
||||
agents: opts.agents,
|
||||
context: opts.context,
|
||||
skills: opts.skills,
|
||||
verbose: opts.verbose,
|
||||
});
|
||||
});
|
||||
}
|
||||
230
packages/cli/src/commands/status.ts
Normal file
230
packages/cli/src/commands/status.ts
Normal file
|
|
@ -0,0 +1,230 @@
|
|||
import { type Command } from 'commander';
|
||||
import { join } from 'node:path';
|
||||
|
||||
import { readCliVersion } from '../lib/version.js';
|
||||
import { readManifest } from '../lib/manifest.js';
|
||||
import { computeFileHash, hashesMatch } from '../lib/sha256.js';
|
||||
import { detectIdes } from '../lib/ide-detect.js';
|
||||
import { log, info, warn, bold, dim, success } from '../ui/logger.js';
|
||||
import type { ManifestFile, ManifestFileType } from '../lib/manifest.js';
|
||||
import type { DetectedIde } from '../lib/ide-detect.js';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type StatusOptions = {
|
||||
verbose: boolean;
|
||||
};
|
||||
|
||||
type ComponentCounts = {
|
||||
agents: number;
|
||||
context: number;
|
||||
skills: number;
|
||||
other: number;
|
||||
total: number;
|
||||
};
|
||||
|
||||
type ModifiedResult = {
|
||||
count: number;
|
||||
paths: string[];
|
||||
};
|
||||
|
||||
// ── Pure counters ─────────────────────────────────────────────────────────────
|
||||
|
||||
/** Counts manifest entries by their file type. Pure function. */
|
||||
const countComponents = (manifest: ManifestFile): ComponentCounts => {
|
||||
const entries = Object.values(manifest.files);
|
||||
const byType = (t: ManifestFileType): number =>
|
||||
entries.filter((e) => e.type === t).length;
|
||||
|
||||
const agents = byType('agent');
|
||||
const context = byType('context');
|
||||
const skills = byType('skill');
|
||||
const other = entries.length - agents - context - skills;
|
||||
|
||||
return { agents, context, skills, other, total: entries.length };
|
||||
};
|
||||
|
||||
// ── SHA256 diff check ─────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Compares each manifest file's stored hash against the file on disk.
|
||||
* Returns the count and paths of files that have been locally modified.
|
||||
* Wraps computeFileHash in try/catch — deleted files are treated as modified.
|
||||
*/
|
||||
const findModifiedFiles = async (
|
||||
projectRoot: string,
|
||||
manifest: ManifestFile,
|
||||
): Promise<ModifiedResult> => {
|
||||
const entries = Object.entries(manifest.files);
|
||||
|
||||
const checks = await Promise.all(
|
||||
entries.map(async ([relPath, entry]) => {
|
||||
const absPath = join(projectRoot, relPath);
|
||||
try {
|
||||
const diskHash = await computeFileHash(absPath);
|
||||
return !hashesMatch(diskHash, entry.sha256) ? relPath : null;
|
||||
} catch {
|
||||
// File deleted or unreadable — counts as modified
|
||||
return relPath;
|
||||
}
|
||||
}),
|
||||
);
|
||||
|
||||
const paths = checks.filter((p): p is string => p !== null);
|
||||
return { count: paths.length, paths };
|
||||
};
|
||||
|
||||
// ── IDE formatter ─────────────────────────────────────────────────────────────
|
||||
|
||||
/** Formats the list of detected IDEs into a display string. Pure function. */
|
||||
const formatIdeList = (ides: DetectedIde[]): string => {
|
||||
const detected = ides.filter((i) => i.detected);
|
||||
const notDetected = ides.filter((i) => !i.detected);
|
||||
|
||||
if (detected.length === 0) {
|
||||
return 'None detected — run `oac apply <ide>` to set up';
|
||||
}
|
||||
|
||||
const detectedNames = detected.map((i) => i.type).join(', ');
|
||||
if (notDetected.length === 0) return detectedNames;
|
||||
|
||||
const notDetectedNames = notDetected.map((i) => i.type).join(', ');
|
||||
return `${detectedNames} (not detected: ${notDetectedNames})`;
|
||||
};
|
||||
|
||||
// ── Update check ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Returns a human-readable update status line. Pure function. */
|
||||
const formatUpdateStatus = (manifestVersion: string, cliVersion: string): string =>
|
||||
manifestVersion === cliVersion
|
||||
? `Up to date (v${cliVersion})`
|
||||
: `Available — manifest has v${manifestVersion}, CLI is v${cliVersion} (run 'oac update')`;
|
||||
|
||||
// ── Timestamp formatter ───────────────────────────────────────────────────────
|
||||
|
||||
/** Formats an ISO timestamp into a readable local date string. Pure function. */
|
||||
const formatTimestamp = (iso: string): string => {
|
||||
try {
|
||||
return new Date(iso).toLocaleString();
|
||||
} catch {
|
||||
return iso;
|
||||
}
|
||||
};
|
||||
|
||||
// ── Display ───────────────────────────────────────────────────────────────────
|
||||
|
||||
/** Prints the one-screen status summary. Side-effect only. */
|
||||
const printStatus = (
|
||||
cliVersion: string,
|
||||
projectRoot: string,
|
||||
manifest: ManifestFile,
|
||||
counts: ComponentCounts,
|
||||
modified: ModifiedResult,
|
||||
ides: DetectedIde[],
|
||||
): void => {
|
||||
const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';
|
||||
const displayPath = projectRoot.startsWith(homeDir)
|
||||
? `~${projectRoot.slice(homeDir.length)}`
|
||||
: projectRoot;
|
||||
|
||||
log('');
|
||||
bold(`OAC v${cliVersion} — ${displayPath}`);
|
||||
log('');
|
||||
|
||||
info(`Agents: ${counts.agents} installed`);
|
||||
info(`Context: ${counts.context} files`);
|
||||
info(`Skills: ${counts.skills} installed`);
|
||||
|
||||
if (modified.count > 0) {
|
||||
warn(`Modified: ${modified.count} file${modified.count !== 1 ? 's' : ''} have local changes`);
|
||||
} else {
|
||||
success(`Modified: No local changes`);
|
||||
}
|
||||
|
||||
info(`Updates: ${formatUpdateStatus(manifest.oacVersion, cliVersion)}`);
|
||||
info(`IDEs: ${formatIdeList(ides)}`);
|
||||
info(`Last updated: ${formatTimestamp(manifest.updatedAt)}`);
|
||||
|
||||
log('');
|
||||
dim(` Run 'oac doctor' for full health check`);
|
||||
log('');
|
||||
};
|
||||
|
||||
/** Prints verbose details about modified files. Side-effect only. */
|
||||
const printVerboseModified = (modified: ModifiedResult): void => {
|
||||
if (modified.count === 0) return;
|
||||
dim(' Modified files:');
|
||||
for (const p of modified.paths) {
|
||||
dim(` • ${p}`);
|
||||
}
|
||||
log('');
|
||||
};
|
||||
|
||||
// ── Command handler ───────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Implements `oac status`:
|
||||
* 1. Reads manifest — exits early with helpful message if not initialized
|
||||
* 2. Counts components by type
|
||||
* 3. Checks for user-modified files via SHA256 comparison
|
||||
* 4. Detects IDEs
|
||||
* 5. Prints one-screen summary
|
||||
* Always exits 0 (read-only command).
|
||||
*/
|
||||
export async function statusCommand(options: StatusOptions): Promise<void> {
|
||||
const projectRoot = process.cwd();
|
||||
const cliVersion = readCliVersion();
|
||||
|
||||
// Step 1: read manifest — not initialized is a valid state, not an error
|
||||
let manifest: ManifestFile | null;
|
||||
try {
|
||||
manifest = await readManifest(projectRoot);
|
||||
} catch (err: unknown) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
log(` OAC manifest is invalid: ${msg}`);
|
||||
log(` Run 'oac init' to reset, or fix .oac/manifest.json manually.`);
|
||||
process.exit(0);
|
||||
return; // unreachable — satisfies TypeScript
|
||||
}
|
||||
|
||||
if (manifest === null) {
|
||||
log('');
|
||||
log(' OAC not initialized. Run \'oac init\' to get started.');
|
||||
log('');
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// Step 2: count components
|
||||
const counts = countComponents(manifest);
|
||||
|
||||
// Steps 3 & 4: check modified files and detect IDEs in parallel
|
||||
const [modified, ides] = await Promise.all([
|
||||
findModifiedFiles(projectRoot, manifest),
|
||||
detectIdes(projectRoot),
|
||||
]);
|
||||
|
||||
// Step 5: print summary
|
||||
printStatus(cliVersion, projectRoot, manifest, counts, modified, ides);
|
||||
|
||||
if (options.verbose) {
|
||||
printVerboseModified(modified);
|
||||
}
|
||||
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// ── Commander registration ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `oac status` command on the given Commander program.
|
||||
* Called by the CLI entry point (index.ts).
|
||||
*/
|
||||
export function registerStatusCommand(program: Command): void {
|
||||
program
|
||||
.command('status')
|
||||
.description('Show a one-screen summary of your OAC installation')
|
||||
.option('--verbose', 'Show details about modified files', false)
|
||||
.action(async (opts: { verbose?: boolean }) => {
|
||||
await statusCommand({ verbose: opts.verbose ?? false });
|
||||
});
|
||||
}
|
||||
197
packages/cli/src/commands/update.ts
Normal file
197
packages/cli/src/commands/update.ts
Normal file
|
|
@ -0,0 +1,197 @@
|
|||
import { type Command } from 'commander';
|
||||
import { updateFiles } from '../lib/installer.js';
|
||||
import { getPackageRoot } from '../lib/bundled.js';
|
||||
import { readManifest, writeManifest } from '../lib/manifest.js';
|
||||
import { readConfig } from '../lib/config.js';
|
||||
import { log, info, warn, error, success, dim, bold, verbose, setVerbose } from '../ui/logger.js';
|
||||
import { createSpinner, setDryRun } from '../ui/spinner.js';
|
||||
import type { InstallResult } from '../lib/installer.js';
|
||||
import type { ManifestFile } from '../lib/manifest.js';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type UpdateOptions = {
|
||||
yolo: boolean;
|
||||
dryRun: boolean;
|
||||
verbose: boolean;
|
||||
/** Alias for dryRun — shows what would change without changing anything. */
|
||||
check: boolean;
|
||||
};
|
||||
|
||||
// ── Pre-flight checks ─────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Validates that a manifest exists before running the update.
|
||||
* Returns the project root (cwd) or exits with code 1.
|
||||
*/
|
||||
async function assertManifestExists(projectRoot: string): Promise<void> {
|
||||
const manifest = await readManifest(projectRoot);
|
||||
if (manifest === null) {
|
||||
error('No manifest found. Run \'oac init\' first.');
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
// ── Plan announcement ─────────────────────────────────────────────────────────
|
||||
|
||||
/** Prints what the command is about to do BEFORE making any changes. */
|
||||
function printPlan(opts: UpdateOptions): void {
|
||||
const mode = opts.dryRun ? ' (dry-run — no changes will be made)' : '';
|
||||
bold(`\noac update${mode}`);
|
||||
info('Checking installed files against the latest OAC bundle...');
|
||||
if (opts.yolo) {
|
||||
warn('--yolo mode: user-modified files will be backed up and overwritten.');
|
||||
}
|
||||
if (opts.verbose) {
|
||||
dim(' Verbose mode: SHA256 comparison details will be shown per file.');
|
||||
}
|
||||
log('');
|
||||
}
|
||||
|
||||
// ── Result summary ────────────────────────────────────────────────────────────
|
||||
|
||||
/** Prints the per-category file lists from the result. */
|
||||
function printFileList(label: string, files: string[], printer: (msg: string) => void): void {
|
||||
if (files.length === 0) return;
|
||||
printer(`${label}:`);
|
||||
for (const f of files) {
|
||||
dim(` ${f}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** Prints the full result summary AFTER the update completes. */
|
||||
function printSummary(result: InstallResult, isDryRun: boolean): void {
|
||||
const prefix = isDryRun ? '[dry-run] Would have: ' : '';
|
||||
log('');
|
||||
bold('Summary:');
|
||||
|
||||
printFileList(` ${prefix}Updated`, result.updated, success);
|
||||
printFileList(` ${prefix}New files installed`, result.installed, success);
|
||||
printFileList(` ${prefix}Backed up (--yolo)`, result.backed_up, info);
|
||||
printFileList(` Skipped (user-modified)`, result.skipped, warn);
|
||||
printFileList(` Removed from manifest (no longer in bundle)`, result.removed_from_manifest, warn);
|
||||
printFileList(` Errors`, result.errors, error);
|
||||
|
||||
log('');
|
||||
const updatedCount = result.updated.length + result.installed.length;
|
||||
const skippedCount = result.skipped.length;
|
||||
const backedUpCount = result.backed_up.length;
|
||||
|
||||
const parts: string[] = [];
|
||||
if (updatedCount > 0) parts.push(`${updatedCount} file(s) updated`);
|
||||
if (skippedCount > 0) parts.push(`${skippedCount} skipped (user-modified)`);
|
||||
if (backedUpCount > 0) parts.push(`${backedUpCount} backed up`);
|
||||
if (result.errors.length > 0) parts.push(`${result.errors.length} error(s)`);
|
||||
|
||||
if (parts.length === 0) {
|
||||
info('Everything is already up to date.');
|
||||
return;
|
||||
}
|
||||
log(parts.join('. ') + '.');
|
||||
}
|
||||
|
||||
// ── Core update logic ─────────────────────────────────────────────────────────
|
||||
|
||||
/** Resolves effective options: --check is an alias for --dry-run. */
|
||||
const resolveOptions = (opts: UpdateOptions): UpdateOptions => ({
|
||||
...opts,
|
||||
dryRun: opts.dryRun || opts.check,
|
||||
});
|
||||
|
||||
/** Runs the update and writes the manifest (unless dry-run). */
|
||||
async function runUpdate(projectRoot: string, opts: UpdateOptions): Promise<InstallResult> {
|
||||
const packageRoot = getPackageRoot();
|
||||
|
||||
const spinner = createSpinner('Scanning files...', { dryRun: opts.dryRun });
|
||||
spinner.start();
|
||||
|
||||
let result: InstallResult;
|
||||
let updatedManifest: ManifestFile;
|
||||
try {
|
||||
({ result, updatedManifest } = await updateFiles({
|
||||
projectRoot,
|
||||
packageRoot,
|
||||
dryRun: opts.dryRun,
|
||||
yolo: opts.yolo,
|
||||
verbose: opts.verbose,
|
||||
}));
|
||||
} catch (err: unknown) {
|
||||
spinner.fail('Update failed.');
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
error(`Update failed: ${msg}`);
|
||||
error('Check that @nextsystems/oac is installed correctly and try again.');
|
||||
process.exit(1);
|
||||
return {} as InstallResult; // unreachable — satisfies TypeScript
|
||||
}
|
||||
|
||||
spinner.succeed('Scan complete.');
|
||||
|
||||
// Write updated manifest only when not in dry-run mode
|
||||
if (!opts.dryRun && result.errors.length === 0) {
|
||||
await writeManifest(projectRoot, updatedManifest);
|
||||
verbose('Manifest written.');
|
||||
} else if (!opts.dryRun && result.errors.length > 0) {
|
||||
warn('Manifest not written due to errors above. Fix the issues and re-run.');
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
// ── Command handler ───────────────────────────────────────────────────────────
|
||||
|
||||
/** Main handler for `oac update`. Orchestrates pre-flight, update, and summary. */
|
||||
async function handleUpdate(opts: UpdateOptions): Promise<void> {
|
||||
const effective = resolveOptions(opts);
|
||||
const projectRoot = process.cwd();
|
||||
|
||||
// Configure global flags
|
||||
setVerbose(effective.verbose);
|
||||
setDryRun(effective.dryRun);
|
||||
|
||||
// Read config to pick up persisted yolo/autoBackup preferences
|
||||
const config = await readConfig(projectRoot);
|
||||
const yolo = effective.yolo || (config?.preferences.yoloMode ?? false);
|
||||
|
||||
const finalOpts: UpdateOptions = { ...effective, yolo };
|
||||
|
||||
// Pre-flight: manifest must exist
|
||||
await assertManifestExists(projectRoot);
|
||||
|
||||
// Announce plan BEFORE doing anything
|
||||
printPlan(finalOpts);
|
||||
|
||||
// Run the update
|
||||
const result = await runUpdate(projectRoot, finalOpts);
|
||||
|
||||
// Print summary AFTER
|
||||
printSummary(result, finalOpts.dryRun);
|
||||
|
||||
// Exit non-zero only on hard errors (skipped files are not errors)
|
||||
if (result.errors.length > 0) {
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
// ── Commander registration ────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Registers the `oac update` command on the given Commander program.
|
||||
* Supports --dry-run, --check (alias), --yolo, --verbose.
|
||||
*/
|
||||
export function registerUpdateCommand(program: Command): void {
|
||||
program
|
||||
.command('update')
|
||||
.description('Update installed OAC files, skipping any you have modified')
|
||||
.option('--dry-run', 'Show what would be updated without making changes')
|
||||
.option('--check', 'Alias for --dry-run: show what would change')
|
||||
.option('--yolo', 'Back up user-modified files and overwrite them anyway')
|
||||
.option('--verbose', 'Show SHA256 comparison details per file')
|
||||
.action(async (cmdOpts: { dryRun?: boolean; check?: boolean; yolo?: boolean; verbose?: boolean }) => {
|
||||
await handleUpdate({
|
||||
dryRun: cmdOpts.dryRun ?? false,
|
||||
check: cmdOpts.check ?? false,
|
||||
yolo: cmdOpts.yolo ?? false,
|
||||
verbose: cmdOpts.verbose ?? false,
|
||||
});
|
||||
});
|
||||
}
|
||||
69
packages/cli/src/index.ts
Normal file
69
packages/cli/src/index.ts
Normal file
|
|
@ -0,0 +1,69 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
import { Command } from 'commander'
|
||||
import { readCliVersion } from './lib/version.js'
|
||||
|
||||
const program = new Command()
|
||||
|
||||
program
|
||||
.name('oac')
|
||||
.description('OpenAgents Control — install, manage, and update AI agents and context files')
|
||||
.version(readCliVersion(), '-v, --version', 'Print version and exit')
|
||||
|
||||
// Lazy-load command modules in parallel — keeps startup < 100ms
|
||||
async function main(): Promise<void> {
|
||||
// Fast path: --version only — --help needs all commands registered first
|
||||
const args = process.argv.slice(2)
|
||||
const isFastPath =
|
||||
args.includes('--version') || args.includes('-v')
|
||||
|
||||
if (isFastPath) {
|
||||
await program.parseAsync(process.argv)
|
||||
return
|
||||
}
|
||||
|
||||
const [
|
||||
{ registerInitCommand },
|
||||
{ registerUpdateCommand },
|
||||
{ registerAddCommand },
|
||||
{ registerApplyCommand },
|
||||
{ registerDoctorCommand },
|
||||
{ registerListCommand },
|
||||
{ registerStatusCommand },
|
||||
] = await Promise.all([
|
||||
import('./commands/init.js'),
|
||||
import('./commands/update.js'),
|
||||
import('./commands/add.js'),
|
||||
import('./commands/apply.js'),
|
||||
import('./commands/doctor.js'),
|
||||
import('./commands/list.js'),
|
||||
import('./commands/status.js'),
|
||||
])
|
||||
|
||||
registerInitCommand(program)
|
||||
registerUpdateCommand(program)
|
||||
registerAddCommand(program) // also registers `remove`
|
||||
registerApplyCommand(program)
|
||||
registerDoctorCommand(program)
|
||||
registerListCommand(program)
|
||||
registerStatusCommand(program)
|
||||
|
||||
// Unknown commands: print a helpful error and exit 1
|
||||
program.on('command:*', (operands: string[]) => {
|
||||
console.error(`error: unknown command '${operands[0]}'\n`)
|
||||
console.error(`Run 'oac --help' to see available commands.`)
|
||||
process.exitCode = 1
|
||||
})
|
||||
|
||||
await program.parseAsync(process.argv)
|
||||
|
||||
// Print help when no command is given
|
||||
if (args.length === 0) {
|
||||
program.help()
|
||||
}
|
||||
}
|
||||
|
||||
main().catch((err: unknown) => {
|
||||
console.error('Fatal error:', err instanceof Error ? err.message : String(err))
|
||||
process.exitCode = 1
|
||||
})
|
||||
334
packages/cli/src/lib/bundled.test.ts
Normal file
334
packages/cli/src/lib/bundled.test.ts
Normal file
|
|
@ -0,0 +1,334 @@
|
|||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import {
|
||||
classifyBundledFile,
|
||||
findPackageRoot,
|
||||
getBundledFilePath,
|
||||
listBundledFiles,
|
||||
bundledFileExists,
|
||||
type BundledFileType,
|
||||
} from './bundled.js';
|
||||
|
||||
// ── classifyBundledFile ───────────────────────────────────────────────────────
|
||||
// Pure function — no I/O, no setup needed.
|
||||
|
||||
describe('classifyBundledFile', () => {
|
||||
// ✅ Positive: agent prefix
|
||||
test('returns "agent" for .opencode/agent/ paths', () => {
|
||||
// Arrange
|
||||
const path = '.opencode/agent/core/openagent.md';
|
||||
// Act
|
||||
const result: BundledFileType = classifyBundledFile(path);
|
||||
// Assert
|
||||
expect(result).toBe('agent');
|
||||
});
|
||||
|
||||
// ✅ Positive: agent prefix — nested deeply
|
||||
test('returns "agent" for deeply nested agent paths', () => {
|
||||
expect(classifyBundledFile('.opencode/agent/sub/dir/file.md')).toBe('agent');
|
||||
});
|
||||
|
||||
// ✅ Positive: context prefix
|
||||
test('returns "context" for .opencode/context/ paths', () => {
|
||||
expect(classifyBundledFile('.opencode/context/standards.md')).toBe('context');
|
||||
});
|
||||
|
||||
// ✅ Positive: context prefix — nested
|
||||
test('returns "context" for nested context paths', () => {
|
||||
expect(classifyBundledFile('.opencode/context/sub/file.md')).toBe('context');
|
||||
});
|
||||
|
||||
// ✅ Positive: skill prefix
|
||||
test('returns "skill" for .opencode/skills/ paths', () => {
|
||||
expect(classifyBundledFile('.opencode/skills/my-skill.md')).toBe('skill');
|
||||
});
|
||||
|
||||
// ✅ Positive: skill prefix — nested
|
||||
test('returns "skill" for nested skills paths', () => {
|
||||
expect(classifyBundledFile('.opencode/skills/category/skill.md')).toBe('skill');
|
||||
});
|
||||
|
||||
// ✅ Positive: config fallback — arbitrary path
|
||||
test('returns "config" for unrecognised paths', () => {
|
||||
expect(classifyBundledFile('some/other/file.json')).toBe('config');
|
||||
});
|
||||
|
||||
// ✅ Positive: config fallback — root-level file
|
||||
test('returns "config" for a root-level file', () => {
|
||||
expect(classifyBundledFile('README.md')).toBe('config');
|
||||
});
|
||||
|
||||
// ❌ Negative: path that starts with .opencode/ but not a known subdir
|
||||
test('returns "config" for .opencode/ paths with unknown subdir', () => {
|
||||
expect(classifyBundledFile('.opencode/unknown/file.md')).toBe('config');
|
||||
});
|
||||
|
||||
// ❌ Negative: partial prefix match should NOT classify as agent
|
||||
test('returns "config" for path that only partially matches agent prefix', () => {
|
||||
// ".opencode/agentX/" is NOT ".opencode/agent/"
|
||||
expect(classifyBundledFile('.opencode/agentX/file.md')).toBe('config');
|
||||
});
|
||||
|
||||
// ❌ Negative: partial prefix match should NOT classify as context
|
||||
test('returns "config" for path that only partially matches context prefix', () => {
|
||||
expect(classifyBundledFile('.opencode/contexts/file.md')).toBe('config');
|
||||
});
|
||||
|
||||
// ❌ Negative: empty string
|
||||
test('returns "config" for an empty string', () => {
|
||||
expect(classifyBundledFile('')).toBe('config');
|
||||
});
|
||||
});
|
||||
|
||||
// ── getBundledFilePath ────────────────────────────────────────────────────────
|
||||
// Pure function — no I/O.
|
||||
|
||||
describe('getBundledFilePath', () => {
|
||||
// ✅ Positive: joins packageRoot and relativePath
|
||||
test('joins packageRoot and relativePath correctly', () => {
|
||||
// Arrange
|
||||
const packageRoot = '/usr/local/lib/oac';
|
||||
const relativePath = '.opencode/agent/core/openagent.md';
|
||||
// Act
|
||||
const result = getBundledFilePath(packageRoot, relativePath);
|
||||
// Assert
|
||||
expect(result).toBe('/usr/local/lib/oac/.opencode/agent/core/openagent.md');
|
||||
});
|
||||
|
||||
// ✅ Positive: works with nested relative paths
|
||||
test('handles nested relative paths', () => {
|
||||
const result = getBundledFilePath('/root', '.opencode/skills/sub/skill.md');
|
||||
expect(result).toBe('/root/.opencode/skills/sub/skill.md');
|
||||
});
|
||||
|
||||
// ❌ Negative: empty relative path returns just the packageRoot
|
||||
test('returns packageRoot when relativePath is empty', () => {
|
||||
const result = getBundledFilePath('/root', '');
|
||||
expect(result).toBe('/root');
|
||||
});
|
||||
});
|
||||
|
||||
// ── findPackageRoot ───────────────────────────────────────────────────────────
|
||||
|
||||
describe('findPackageRoot', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-bundled-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: finds a directory that has both .opencode/ and package.json
|
||||
test('returns the directory that has both .opencode/ and package.json', async () => {
|
||||
// Arrange — create a fake package root
|
||||
const fakeRoot = join(tmpDir, 'fake-pkg');
|
||||
await mkdir(join(fakeRoot, '.opencode'), { recursive: true });
|
||||
await writeFile(join(fakeRoot, 'package.json'), '{}', 'utf8');
|
||||
// Also create a subdirectory to start the walk from
|
||||
const startDir = join(fakeRoot, 'dist', 'lib');
|
||||
await mkdir(startDir, { recursive: true });
|
||||
|
||||
// Act
|
||||
const result = findPackageRoot(startDir);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(fakeRoot);
|
||||
});
|
||||
|
||||
// ✅ Positive: finds root when starting exactly at the package root
|
||||
test('returns the start directory itself when it is the package root', async () => {
|
||||
// Arrange
|
||||
const fakeRoot = join(tmpDir, 'exact-root');
|
||||
await mkdir(join(fakeRoot, '.opencode'), { recursive: true });
|
||||
await writeFile(join(fakeRoot, 'package.json'), '{}', 'utf8');
|
||||
|
||||
// Act
|
||||
const result = findPackageRoot(fakeRoot);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(fakeRoot);
|
||||
});
|
||||
|
||||
// ❌ Negative: throws when no package root is found (isolated tmp dir with no markers)
|
||||
test('throws an error when no package root is found walking to filesystem root', async () => {
|
||||
// Arrange — a directory with neither .opencode/ nor package.json
|
||||
const isolated = join(tmpDir, 'isolated-no-markers');
|
||||
await mkdir(isolated, { recursive: true });
|
||||
|
||||
// Act & Assert — we cannot actually walk to the real filesystem root in a
|
||||
// test (it would find the monorepo's package.json), so we test the error
|
||||
// message shape by checking that a directory missing .opencode throws when
|
||||
// the walk terminates. We use a path that IS the filesystem root equivalent
|
||||
// by mocking: instead, we verify the thrown error message format by calling
|
||||
// with a path that has package.json but no .opencode, and one that has
|
||||
// .opencode but no package.json — neither should match, but the walk will
|
||||
// eventually reach the real monorepo root. So we test the error path by
|
||||
// verifying the function throws when given a path that cannot possibly
|
||||
// resolve (we use the OS tmpdir itself, which has no .opencode).
|
||||
//
|
||||
// The safest approach: create a temp dir tree that is self-contained and
|
||||
// has no .opencode anywhere. We can't prevent the walk from going above
|
||||
// tmpdir, so we test the error message by checking it contains the
|
||||
// expected substring when we know it will throw.
|
||||
//
|
||||
// NOTE: In CI / a clean environment this will throw because there is no
|
||||
// .opencode above the tmpdir. In a monorepo dev environment the walk may
|
||||
// find the repo root. We therefore test the error *shape* by directly
|
||||
// calling with a path that we know will fail: the filesystem root '/'.
|
||||
expect(() => findPackageRoot('/')).toThrow(
|
||||
'getPackageRoot: could not find a directory with ".opencode/" and "package.json"',
|
||||
);
|
||||
});
|
||||
|
||||
// ❌ Negative: error message includes the start directory
|
||||
test('error message includes the starting directory', () => {
|
||||
// Arrange & Act & Assert
|
||||
let thrownMessage = '';
|
||||
try {
|
||||
findPackageRoot('/');
|
||||
} catch (err) {
|
||||
thrownMessage = err instanceof Error ? err.message : String(err);
|
||||
}
|
||||
expect(thrownMessage).toContain('"/"');
|
||||
});
|
||||
|
||||
// ❌ Negative: directory with only package.json (no .opencode) does not match
|
||||
test('does not match a directory that has package.json but no .opencode', async () => {
|
||||
// Arrange — a directory with only package.json, no .opencode
|
||||
const noOpencode = join(tmpDir, 'no-opencode');
|
||||
await mkdir(noOpencode, { recursive: true });
|
||||
await writeFile(join(noOpencode, 'package.json'), '{}', 'utf8');
|
||||
// Start from a child — the walk will pass through noOpencode (no match)
|
||||
// and continue upward until it finds the monorepo root or throws.
|
||||
// We just verify it does NOT return noOpencode.
|
||||
let result: string | undefined;
|
||||
try {
|
||||
result = findPackageRoot(noOpencode);
|
||||
} catch {
|
||||
result = undefined;
|
||||
}
|
||||
// If it found something, it must NOT be noOpencode (which lacks .opencode)
|
||||
if (result !== undefined) {
|
||||
expect(result).not.toBe(noOpencode);
|
||||
}
|
||||
// Either it threw (correct) or found a higher-level root (also acceptable)
|
||||
expect(true).toBe(true); // test passes either way — the key is it didn't return noOpencode
|
||||
});
|
||||
});
|
||||
|
||||
// ── listBundledFiles ──────────────────────────────────────────────────────────
|
||||
|
||||
describe('listBundledFiles', () => {
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-list-bundled-'));
|
||||
|
||||
// Create a fake package structure with files in all three subdirs
|
||||
await mkdir(join(packageRoot, '.opencode', 'agent', 'core'), { recursive: true });
|
||||
await mkdir(join(packageRoot, '.opencode', 'context'), { recursive: true });
|
||||
await mkdir(join(packageRoot, '.opencode', 'skills', 'sub'), { recursive: true });
|
||||
|
||||
await writeFile(join(packageRoot, '.opencode', 'agent', 'core', 'openagent.md'), '# Agent', 'utf8');
|
||||
await writeFile(join(packageRoot, '.opencode', 'agent', 'helper.md'), '# Helper', 'utf8');
|
||||
await writeFile(join(packageRoot, '.opencode', 'context', 'standards.md'), '# Standards', 'utf8');
|
||||
await writeFile(join(packageRoot, '.opencode', 'skills', 'sub', 'skill.md'), '# Skill', 'utf8');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: returns relative paths for all files in all three subdirs
|
||||
test('returns relative paths for all bundled files', async () => {
|
||||
// Act
|
||||
const files = await listBundledFiles(packageRoot);
|
||||
|
||||
// Assert — all four files should be present
|
||||
expect(files).toContain('.opencode/agent/core/openagent.md');
|
||||
expect(files).toContain('.opencode/agent/helper.md');
|
||||
expect(files).toContain('.opencode/context/standards.md');
|
||||
expect(files).toContain('.opencode/skills/sub/skill.md');
|
||||
expect(files).toHaveLength(4);
|
||||
});
|
||||
|
||||
// ✅ Positive: paths are relative (not absolute)
|
||||
test('returns relative paths, not absolute paths', async () => {
|
||||
const files = await listBundledFiles(packageRoot);
|
||||
for (const f of files) {
|
||||
expect(f.startsWith('/')).toBe(false);
|
||||
}
|
||||
});
|
||||
|
||||
// ✅ Positive: paths start with .opencode/
|
||||
test('all returned paths start with .opencode/', async () => {
|
||||
const files = await listBundledFiles(packageRoot);
|
||||
for (const f of files) {
|
||||
expect(f.startsWith('.opencode/')).toBe(true);
|
||||
}
|
||||
});
|
||||
|
||||
// ❌ Negative: missing subdirectories are silently skipped
|
||||
test('silently skips subdirectories that do not exist', async () => {
|
||||
// Arrange — a package root with only the agent subdir
|
||||
const sparseRoot = await mkdtemp(join(tmpdir(), 'oac-sparse-pkg-'));
|
||||
try {
|
||||
await mkdir(join(sparseRoot, '.opencode', 'agent'), { recursive: true });
|
||||
await writeFile(join(sparseRoot, '.opencode', 'agent', 'only.md'), '# Only', 'utf8');
|
||||
|
||||
// Act — context/ and skills/ don't exist
|
||||
const files = await listBundledFiles(sparseRoot);
|
||||
|
||||
// Assert — only the agent file, no errors
|
||||
expect(files).toHaveLength(1);
|
||||
expect(files[0]).toBe('.opencode/agent/only.md');
|
||||
} finally {
|
||||
await rm(sparseRoot, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
|
||||
// ❌ Negative: empty package root returns empty array
|
||||
test('returns empty array when no bundled subdirs exist', async () => {
|
||||
// Arrange — completely empty package root
|
||||
const emptyRoot = await mkdtemp(join(tmpdir(), 'oac-empty-pkg-'));
|
||||
try {
|
||||
const files = await listBundledFiles(emptyRoot);
|
||||
expect(files).toHaveLength(0);
|
||||
} finally {
|
||||
await rm(emptyRoot, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
// ── bundledFileExists ─────────────────────────────────────────────────────────
|
||||
|
||||
describe('bundledFileExists', () => {
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-exists-test-'));
|
||||
await mkdir(join(packageRoot, '.opencode', 'agent'), { recursive: true });
|
||||
await writeFile(join(packageRoot, '.opencode', 'agent', 'present.md'), '# Present', 'utf8');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: returns true for a file that exists
|
||||
test('returns true when the bundled file exists', async () => {
|
||||
const exists = await bundledFileExists(packageRoot, '.opencode/agent/present.md');
|
||||
expect(exists).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: returns false for a file that does not exist
|
||||
test('returns false when the bundled file does not exist', async () => {
|
||||
const exists = await bundledFileExists(packageRoot, '.opencode/agent/missing.md');
|
||||
expect(exists).toBe(false);
|
||||
});
|
||||
});
|
||||
164
packages/cli/src/lib/bundled.ts
Normal file
164
packages/cli/src/lib/bundled.ts
Normal file
|
|
@ -0,0 +1,164 @@
|
|||
import { existsSync } from "node:fs";
|
||||
import { readdir, stat } from "node:fs/promises";
|
||||
import { join, relative } from "node:path";
|
||||
|
||||
// --- Types ---
|
||||
|
||||
/** The category of a bundled file, inferred from its path prefix. */
|
||||
export type BundledFileType = "agent" | "context" | "skill" | "config";
|
||||
|
||||
// --- Constants ---
|
||||
|
||||
/** Subdirectories under the package root that contain bundled OAC files. */
|
||||
const BUNDLED_SUBDIRS = [
|
||||
".opencode/agent",
|
||||
".opencode/context",
|
||||
".opencode/skills",
|
||||
] as const;
|
||||
|
||||
// --- Package root resolution ---
|
||||
|
||||
/**
|
||||
* Walks up the directory tree from `startDir` until it finds a directory
|
||||
* that contains both `.opencode/` and `package.json` — the npm package root.
|
||||
*
|
||||
* Works in both development (monorepo) and when installed via npm.
|
||||
* import.meta.dir is Bun's native equivalent of __dirname.
|
||||
*/
|
||||
export function getPackageRoot(): string {
|
||||
// Allow dev/monorepo override via environment variable.
|
||||
// In production (npm install), OAC_PACKAGE_ROOT is not set so the walk runs as before.
|
||||
// In dev, set OAC_PACKAGE_ROOT=/path/to/repo to bypass the walk entirely.
|
||||
const envOverride = process.env['OAC_PACKAGE_ROOT'];
|
||||
if (envOverride) {
|
||||
return envOverride;
|
||||
}
|
||||
// import.meta.dir is Bun's native equivalent of __dirname — points to packages/cli/dist/ at runtime
|
||||
return findPackageRoot(import.meta.dir);
|
||||
}
|
||||
|
||||
/**
|
||||
* Synchronously walks up from `dir` until finding a directory that has
|
||||
* all three anchors:
|
||||
* 1. `.opencode/` — OAC configuration directory
|
||||
* 2. `package.json` — npm package manifest
|
||||
* 3. No `registry.json` at the same level — `registry.json` is present at
|
||||
* the monorepo root but NOT at the CLI package root, so its absence
|
||||
* distinguishes the CLI package from the repo root in a monorepo layout.
|
||||
*
|
||||
* Throws if the filesystem root is reached without finding a match.
|
||||
*
|
||||
* Pure in intent — no side effects beyond filesystem reads.
|
||||
*/
|
||||
export function findPackageRoot(dir: string): string {
|
||||
let current = dir;
|
||||
|
||||
while (true) {
|
||||
const hasOpencode = existsSync(join(current, ".opencode"));
|
||||
const hasPackageJson = existsSync(join(current, "package.json"));
|
||||
// registry.json exists at the monorepo root but NOT at the CLI package root.
|
||||
// Excluding directories that have it prevents the walk from stopping at the
|
||||
// repo root instead of the actual CLI package root.
|
||||
const hasRegistryJson = existsSync(join(current, "registry.json"));
|
||||
|
||||
if (hasOpencode && hasPackageJson && !hasRegistryJson) {
|
||||
return current;
|
||||
}
|
||||
|
||||
const parent = join(current, "..");
|
||||
// Reached filesystem root — no package root found
|
||||
if (parent === current) {
|
||||
throw new Error(
|
||||
`getPackageRoot: could not find a directory with ".opencode/" and "package.json" ` +
|
||||
`(without a "registry.json" at the same level) walking up from "${dir}". ` +
|
||||
`Is @nextsystems/oac installed correctly? ` +
|
||||
`In dev/monorepo mode, set OAC_PACKAGE_ROOT env var to the repo root.`,
|
||||
);
|
||||
}
|
||||
current = parent;
|
||||
}
|
||||
}
|
||||
|
||||
// --- Path helpers ---
|
||||
|
||||
/**
|
||||
* Returns the absolute path to a bundled file given the package root and a
|
||||
* relative path (e.g. `.opencode/agent/core/openagent.md`).
|
||||
*
|
||||
* Pure function — no I/O.
|
||||
*/
|
||||
export const getBundledFilePath = (
|
||||
packageRoot: string,
|
||||
relativePath: string,
|
||||
): string => join(packageRoot, relativePath);
|
||||
|
||||
// --- File enumeration ---
|
||||
|
||||
/**
|
||||
* Recursively collects all file paths under `dir`, returning them as
|
||||
* absolute paths. Directories are not included in the result.
|
||||
*/
|
||||
async function collectFiles(dir: string): Promise<string[]> {
|
||||
const entries = await readdir(dir, { withFileTypes: true });
|
||||
|
||||
const nested = await Promise.all(
|
||||
entries.map((entry) => {
|
||||
const fullPath = join(dir, entry.name);
|
||||
return entry.isDirectory() ? collectFiles(fullPath) : Promise.resolve([fullPath]);
|
||||
}),
|
||||
);
|
||||
|
||||
return nested.flat();
|
||||
}
|
||||
|
||||
/**
|
||||
* Lists all files under `.opencode/agent/`, `.opencode/context/`, and
|
||||
* `.opencode/skills/` within the given package root.
|
||||
*
|
||||
* Returns relative paths like `.opencode/agent/core/openagent.md`.
|
||||
* Subdirectories that do not exist are silently skipped.
|
||||
*/
|
||||
export async function listBundledFiles(packageRoot: string): Promise<string[]> {
|
||||
const results = await Promise.all(
|
||||
BUNDLED_SUBDIRS.map(async (subdir) => {
|
||||
const absSubdir = join(packageRoot, subdir);
|
||||
const exists = await stat(absSubdir).then((s) => s.isDirectory()).catch(() => false);
|
||||
if (!exists) return [];
|
||||
|
||||
const absFiles = await collectFiles(absSubdir);
|
||||
return absFiles.map((absFile) => relative(packageRoot, absFile));
|
||||
}),
|
||||
);
|
||||
|
||||
return results.flat();
|
||||
}
|
||||
|
||||
// --- Existence check ---
|
||||
|
||||
/**
|
||||
* Returns true if the bundled file at `relativePath` exists within the
|
||||
* given package root.
|
||||
*/
|
||||
export const bundledFileExists = async (
|
||||
packageRoot: string,
|
||||
relativePath: string,
|
||||
): Promise<boolean> => Bun.file(getBundledFilePath(packageRoot, relativePath)).exists();
|
||||
|
||||
// --- Classification ---
|
||||
|
||||
/**
|
||||
* Infers the BundledFileType from a relative path prefix.
|
||||
*
|
||||
* - `.opencode/agent/...` → "agent"
|
||||
* - `.opencode/context/...` → "context"
|
||||
* - `.opencode/skills/...` → "skill"
|
||||
* - anything else → "config"
|
||||
*
|
||||
* Pure function — no I/O.
|
||||
*/
|
||||
export const classifyBundledFile = (relativePath: string): BundledFileType => {
|
||||
if (relativePath.startsWith(".opencode/agent/")) return "agent";
|
||||
if (relativePath.startsWith(".opencode/context/")) return "context";
|
||||
if (relativePath.startsWith(".opencode/skills/")) return "skill";
|
||||
return "config";
|
||||
};
|
||||
298
packages/cli/src/lib/config.test.ts
Normal file
298
packages/cli/src/lib/config.test.ts
Normal file
|
|
@ -0,0 +1,298 @@
|
|||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm, mkdir } from 'node:fs/promises';
|
||||
import { join, dirname } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import {
|
||||
readConfig,
|
||||
writeConfig,
|
||||
createDefaultConfig,
|
||||
mergeConfig,
|
||||
isYoloMode,
|
||||
isAutoBackup,
|
||||
getConfigPath,
|
||||
} from './config.js';
|
||||
|
||||
// ── getConfigPath ─────────────────────────────────────────────────────────────
|
||||
// Pure function — no I/O.
|
||||
|
||||
describe('getConfigPath', () => {
|
||||
// ✅ Positive: returns the expected path
|
||||
test('returns .oac/config.json under the project root', () => {
|
||||
// Arrange
|
||||
const projectRoot = '/home/user/my-project';
|
||||
// Act
|
||||
const result = getConfigPath(projectRoot);
|
||||
// Assert
|
||||
expect(result).toBe('/home/user/my-project/.oac/config.json');
|
||||
});
|
||||
|
||||
// ✅ Positive: works with trailing slash stripped by path.join
|
||||
test('handles project roots without trailing slash', () => {
|
||||
const result = getConfigPath('/tmp/proj');
|
||||
expect(result).toEndWith('/.oac/config.json');
|
||||
});
|
||||
});
|
||||
|
||||
// ── createDefaultConfig ───────────────────────────────────────────────────────
|
||||
// Pure function — no I/O.
|
||||
|
||||
describe('createDefaultConfig', () => {
|
||||
// ✅ Positive: returns version "1"
|
||||
test('returns a config with version "1"', () => {
|
||||
const config = createDefaultConfig();
|
||||
expect(config.version).toBe('1');
|
||||
});
|
||||
|
||||
// ✅ Positive: yoloMode defaults to false
|
||||
test('yoloMode defaults to false', () => {
|
||||
const config = createDefaultConfig();
|
||||
expect(config.preferences.yoloMode).toBe(false);
|
||||
});
|
||||
|
||||
// ✅ Positive: autoBackup defaults to true
|
||||
test('autoBackup defaults to true', () => {
|
||||
const config = createDefaultConfig();
|
||||
expect(config.preferences.autoBackup).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: two calls return independent objects (no shared reference)
|
||||
test('returns a new object on each call', () => {
|
||||
const a = createDefaultConfig();
|
||||
const b = createDefaultConfig();
|
||||
// Mutating one should not affect the other
|
||||
a.preferences.yoloMode = true;
|
||||
expect(b.preferences.yoloMode).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// ── mergeConfig ───────────────────────────────────────────────────────────────
|
||||
// Pure function — no I/O.
|
||||
|
||||
describe('mergeConfig', () => {
|
||||
// ✅ Positive: overrides a single preference field
|
||||
test('overrides yoloMode when provided', () => {
|
||||
// Arrange
|
||||
const base = createDefaultConfig();
|
||||
// Act
|
||||
const merged = mergeConfig(base, { yoloMode: true });
|
||||
// Assert
|
||||
expect(merged.preferences.yoloMode).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: preserves unspecified preference fields
|
||||
test('preserves autoBackup when only yoloMode is overridden', () => {
|
||||
const base = createDefaultConfig(); // autoBackup: true
|
||||
const merged = mergeConfig(base, { yoloMode: true });
|
||||
expect(merged.preferences.autoBackup).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: overrides autoBackup
|
||||
test('overrides autoBackup when provided', () => {
|
||||
const base = createDefaultConfig();
|
||||
const merged = mergeConfig(base, { autoBackup: false });
|
||||
expect(merged.preferences.autoBackup).toBe(false);
|
||||
});
|
||||
|
||||
// ✅ Positive: overrides both fields simultaneously
|
||||
test('overrides both fields when both are provided', () => {
|
||||
const base = createDefaultConfig();
|
||||
const merged = mergeConfig(base, { yoloMode: true, autoBackup: false });
|
||||
expect(merged.preferences.yoloMode).toBe(true);
|
||||
expect(merged.preferences.autoBackup).toBe(false);
|
||||
});
|
||||
|
||||
// ❌ Negative: does not mutate the base config
|
||||
test('does not mutate the base config', () => {
|
||||
const base = createDefaultConfig();
|
||||
mergeConfig(base, { yoloMode: true });
|
||||
expect(base.preferences.yoloMode).toBe(false);
|
||||
});
|
||||
|
||||
// ❌ Negative: empty overrides returns equivalent config
|
||||
test('empty overrides returns config with same preference values', () => {
|
||||
const base = createDefaultConfig();
|
||||
const merged = mergeConfig(base, {});
|
||||
expect(merged.preferences.yoloMode).toBe(base.preferences.yoloMode);
|
||||
expect(merged.preferences.autoBackup).toBe(base.preferences.autoBackup);
|
||||
});
|
||||
});
|
||||
|
||||
// ── isYoloMode ────────────────────────────────────────────────────────────────
|
||||
// Note: isYoloMode also checks process.env.CI — we test both branches.
|
||||
|
||||
describe('isYoloMode', () => {
|
||||
// ✅ Positive: returns true when yoloMode preference is true
|
||||
test('returns true when config.preferences.yoloMode is true', () => {
|
||||
// Arrange
|
||||
const config = mergeConfig(createDefaultConfig(), { yoloMode: true });
|
||||
// Act & Assert
|
||||
// Temporarily clear CI to isolate the preference check
|
||||
const savedCI = process.env['CI'];
|
||||
delete process.env['CI'];
|
||||
try {
|
||||
expect(isYoloMode(config)).toBe(true);
|
||||
} finally {
|
||||
if (savedCI !== undefined) process.env['CI'] = savedCI;
|
||||
}
|
||||
});
|
||||
|
||||
// ✅ Positive: returns true when CI env var is "true" (even if preference is false)
|
||||
test('returns true when process.env.CI is "true"', () => {
|
||||
const config = createDefaultConfig(); // yoloMode: false
|
||||
const savedCI = process.env['CI'];
|
||||
process.env['CI'] = 'true';
|
||||
try {
|
||||
expect(isYoloMode(config)).toBe(true);
|
||||
} finally {
|
||||
if (savedCI !== undefined) {
|
||||
process.env['CI'] = savedCI;
|
||||
} else {
|
||||
delete process.env['CI'];
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
// ❌ Negative: returns false when yoloMode is false and CI is not set
|
||||
test('returns false when yoloMode is false and CI is not "true"', () => {
|
||||
const config = createDefaultConfig(); // yoloMode: false
|
||||
const savedCI = process.env['CI'];
|
||||
delete process.env['CI'];
|
||||
try {
|
||||
expect(isYoloMode(config)).toBe(false);
|
||||
} finally {
|
||||
if (savedCI !== undefined) process.env['CI'] = savedCI;
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
// ── isAutoBackup ──────────────────────────────────────────────────────────────
|
||||
|
||||
describe('isAutoBackup', () => {
|
||||
// ✅ Positive: returns true when autoBackup is true
|
||||
test('returns true when autoBackup preference is true', () => {
|
||||
const config = createDefaultConfig(); // autoBackup: true
|
||||
expect(isAutoBackup(config)).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: returns false when autoBackup is false
|
||||
test('returns false when autoBackup preference is false', () => {
|
||||
const config = mergeConfig(createDefaultConfig(), { autoBackup: false });
|
||||
expect(isAutoBackup(config)).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// ── readConfig / writeConfig (I/O round-trip) ─────────────────────────────────
|
||||
|
||||
describe('readConfig / writeConfig', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-config-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: readConfig returns null when no config file exists
|
||||
test('readConfig returns null when config file does not exist', async () => {
|
||||
// Arrange — fresh tmpDir has no .oac/config.json
|
||||
const emptyDir = join(tmpDir, 'empty');
|
||||
// Act
|
||||
const result = await readConfig(emptyDir);
|
||||
// Assert
|
||||
expect(result).toBeNull();
|
||||
});
|
||||
|
||||
// ✅ Positive: writeConfig creates .oac/ dir and writes the file
|
||||
test('writeConfig creates .oac/ directory and writes config.json', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'write-test');
|
||||
const config = createDefaultConfig();
|
||||
// Act
|
||||
await writeConfig(projectRoot, config);
|
||||
// Assert — file should now exist
|
||||
const configPath = getConfigPath(projectRoot);
|
||||
expect(await Bun.file(configPath).exists()).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: round-trip — write then read returns the same config
|
||||
test('writeConfig then readConfig round-trips the default config', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'roundtrip-default');
|
||||
const original = createDefaultConfig();
|
||||
// Act
|
||||
await writeConfig(projectRoot, original);
|
||||
const read = await readConfig(projectRoot);
|
||||
// Assert
|
||||
expect(read).not.toBeNull();
|
||||
expect(read?.version).toBe('1');
|
||||
expect(read?.preferences.yoloMode).toBe(false);
|
||||
expect(read?.preferences.autoBackup).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: round-trip preserves non-default preference values
|
||||
test('writeConfig then readConfig round-trips a modified config', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'roundtrip-modified');
|
||||
const config = mergeConfig(createDefaultConfig(), { yoloMode: true, autoBackup: false });
|
||||
// Act
|
||||
await writeConfig(projectRoot, config);
|
||||
const read = await readConfig(projectRoot);
|
||||
// Assert
|
||||
expect(read?.preferences.yoloMode).toBe(true);
|
||||
expect(read?.preferences.autoBackup).toBe(false);
|
||||
});
|
||||
|
||||
// ✅ Positive: writeConfig is idempotent — second write overwrites first
|
||||
test('second writeConfig call overwrites the first', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'overwrite-test');
|
||||
const first = createDefaultConfig();
|
||||
const second = mergeConfig(createDefaultConfig(), { yoloMode: true });
|
||||
// Act
|
||||
await writeConfig(projectRoot, first);
|
||||
await writeConfig(projectRoot, second);
|
||||
const read = await readConfig(projectRoot);
|
||||
// Assert
|
||||
expect(read?.preferences.yoloMode).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: readConfig throws for invalid JSON structure
|
||||
test('readConfig throws an error when config JSON is structurally invalid', async () => {
|
||||
// Arrange — write a config with a bad version field
|
||||
const projectRoot = join(tmpDir, 'bad-config');
|
||||
const configPath = getConfigPath(projectRoot);
|
||||
// Create the .oac/ directory first (Bun.write does not auto-create parent dirs)
|
||||
await mkdir(dirname(configPath), { recursive: true });
|
||||
// Write invalid config (version must be literal "1")
|
||||
await Bun.write(configPath, JSON.stringify({ version: '99', preferences: {} }));
|
||||
// Act & Assert
|
||||
await expect(readConfig(projectRoot)).rejects.toThrow();
|
||||
});
|
||||
|
||||
// ❌ Negative: readConfig throws for missing required fields
|
||||
test('readConfig throws when preferences field is missing', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'missing-prefs');
|
||||
const configPath = getConfigPath(projectRoot);
|
||||
await mkdir(dirname(configPath), { recursive: true });
|
||||
await Bun.write(configPath, JSON.stringify({ version: '1' }));
|
||||
// Act & Assert
|
||||
await expect(readConfig(projectRoot)).rejects.toThrow();
|
||||
});
|
||||
|
||||
// ❌ Negative: readConfig throws for wrong preference types
|
||||
test('readConfig throws when preference values have wrong types', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'wrong-types');
|
||||
const configPath = getConfigPath(projectRoot);
|
||||
await mkdir(dirname(configPath), { recursive: true });
|
||||
await Bun.write(
|
||||
configPath,
|
||||
JSON.stringify({ version: '1', preferences: { yoloMode: 'yes', autoBackup: 1 } }),
|
||||
);
|
||||
// Act & Assert
|
||||
await expect(readConfig(projectRoot)).rejects.toThrow();
|
||||
});
|
||||
});
|
||||
50
packages/cli/src/lib/config.ts
Normal file
50
packages/cli/src/lib/config.ts
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
import { z } from "zod";
|
||||
import { mkdir } from "node:fs/promises";
|
||||
import { join, dirname } from "node:path";
|
||||
|
||||
export const OacPreferencesSchema = z.object({
|
||||
yoloMode: z.boolean(),
|
||||
autoBackup: z.boolean(),
|
||||
});
|
||||
export const OacConfigSchema = z.object({
|
||||
version: z.literal("1"),
|
||||
preferences: OacPreferencesSchema,
|
||||
});
|
||||
|
||||
export type OacPreferences = z.infer<typeof OacPreferencesSchema>;
|
||||
export type OacConfig = z.infer<typeof OacConfigSchema>;
|
||||
|
||||
export const getConfigPath = (projectRoot: string): string =>
|
||||
join(projectRoot, ".oac", "config.json");
|
||||
|
||||
export const createDefaultConfig = (): OacConfig => ({
|
||||
version: "1",
|
||||
preferences: { yoloMode: false, autoBackup: true },
|
||||
});
|
||||
|
||||
// Pure — returns new object, no mutation
|
||||
export const mergeConfig = (base: OacConfig, overrides: Partial<OacPreferences>): OacConfig =>
|
||||
({ ...base, preferences: { ...base.preferences, ...overrides } });
|
||||
|
||||
export const isYoloMode = (config: OacConfig): boolean =>
|
||||
config.preferences.yoloMode || process.env["CI"] === "true";
|
||||
|
||||
export const isAutoBackup = (config: OacConfig): boolean =>
|
||||
config.preferences.autoBackup;
|
||||
|
||||
export async function readConfig(projectRoot: string): Promise<OacConfig | null> {
|
||||
const configPath = getConfigPath(projectRoot);
|
||||
if (!(await Bun.file(configPath).exists())) return null;
|
||||
const raw = await Bun.file(configPath).json() as unknown;
|
||||
const result = OacConfigSchema.safeParse(raw);
|
||||
if (!result.success) {
|
||||
throw new Error(`Invalid config at "${configPath}": ${result.error.message}`);
|
||||
}
|
||||
return result.data;
|
||||
}
|
||||
|
||||
export async function writeConfig(projectRoot: string, config: OacConfig): Promise<void> {
|
||||
const configPath = getConfigPath(projectRoot);
|
||||
await mkdir(dirname(configPath), { recursive: true });
|
||||
await Bun.write(configPath, JSON.stringify(config, null, 2));
|
||||
}
|
||||
401
packages/cli/src/lib/ide-detect.test.ts
Normal file
401
packages/cli/src/lib/ide-detect.test.ts
Normal file
|
|
@ -0,0 +1,401 @@
|
|||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import {
|
||||
detectIde,
|
||||
detectIdes,
|
||||
isIdePresent,
|
||||
getIdeOutputFile,
|
||||
getIdeDisplayName,
|
||||
} from './ide-detect.js';
|
||||
|
||||
// ── getIdeOutputFile ───────────────────────────────────────────────────────────
|
||||
// Pure function — no I/O.
|
||||
|
||||
describe('getIdeOutputFile', () => {
|
||||
// ✅ Positive: cursor maps to .cursorrules
|
||||
test('cursor → .cursorrules', () => {
|
||||
expect(getIdeOutputFile('cursor')).toBe('.cursorrules');
|
||||
});
|
||||
|
||||
// ✅ Positive: claude maps to CLAUDE.md
|
||||
test('claude → CLAUDE.md', () => {
|
||||
expect(getIdeOutputFile('claude')).toBe('CLAUDE.md');
|
||||
});
|
||||
|
||||
// ✅ Positive: windsurf maps to .windsurfrules
|
||||
test('windsurf → .windsurfrules', () => {
|
||||
expect(getIdeOutputFile('windsurf')).toBe('.windsurfrules');
|
||||
});
|
||||
|
||||
// ✅ Positive: opencode maps to .opencode/
|
||||
test('opencode → .opencode/', () => {
|
||||
expect(getIdeOutputFile('opencode')).toBe('.opencode/');
|
||||
});
|
||||
});
|
||||
|
||||
// ── getIdeDisplayName ─────────────────────────────────────────────────────────
|
||||
// Pure function — no I/O.
|
||||
|
||||
describe('getIdeDisplayName', () => {
|
||||
// ✅ Positive: cursor → Cursor
|
||||
test('cursor → Cursor', () => {
|
||||
expect(getIdeDisplayName('cursor')).toBe('Cursor');
|
||||
});
|
||||
|
||||
// ✅ Positive: claude → Claude
|
||||
test('claude → Claude', () => {
|
||||
expect(getIdeDisplayName('claude')).toBe('Claude');
|
||||
});
|
||||
|
||||
// ✅ Positive: windsurf → Windsurf
|
||||
test('windsurf → Windsurf', () => {
|
||||
expect(getIdeDisplayName('windsurf')).toBe('Windsurf');
|
||||
});
|
||||
|
||||
// ✅ Positive: opencode → OpenCode
|
||||
test('opencode → OpenCode', () => {
|
||||
expect(getIdeDisplayName('opencode')).toBe('OpenCode');
|
||||
});
|
||||
});
|
||||
|
||||
// ── detectIde — directory-based IDEs ─────────────────────────────────────────
|
||||
// These are the critical tests that verify the stat-based directory detection
|
||||
// fix works correctly (Bun.file().exists() always returns false for directories).
|
||||
|
||||
describe('detectIde — opencode (directory-based)', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-ide-detect-opencode-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: .opencode/ directory present → detected: true
|
||||
test('detected: true when .opencode/ directory exists', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'with-opencode');
|
||||
await mkdir(join(projectRoot, '.opencode'), { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'opencode');
|
||||
// Assert
|
||||
expect(result.type).toBe('opencode');
|
||||
expect(result.detected).toBe(true);
|
||||
expect(result.indicator).toContain('.opencode');
|
||||
});
|
||||
|
||||
// ❌ Negative: .opencode/ directory absent → detected: false
|
||||
test('detected: false when .opencode/ directory does not exist', async () => {
|
||||
// Arrange — fresh directory with no .opencode/ inside
|
||||
const projectRoot = join(tmpDir, 'without-opencode');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'opencode');
|
||||
// Assert
|
||||
expect(result.type).toBe('opencode');
|
||||
expect(result.detected).toBe(false);
|
||||
expect(result.indicator).toContain('.opencode');
|
||||
});
|
||||
});
|
||||
|
||||
describe('detectIde — cursor (directory-based)', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-ide-detect-cursor-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: .cursor/ directory present → detected: true
|
||||
test('detected: true when .cursor/ directory exists', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'with-cursor');
|
||||
await mkdir(join(projectRoot, '.cursor'), { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'cursor');
|
||||
// Assert
|
||||
expect(result.type).toBe('cursor');
|
||||
expect(result.detected).toBe(true);
|
||||
expect(result.indicator).toContain('.cursor');
|
||||
});
|
||||
|
||||
// ❌ Negative: .cursor/ directory absent → detected: false
|
||||
test('detected: false when .cursor/ directory does not exist', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'without-cursor');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'cursor');
|
||||
// Assert
|
||||
expect(result.type).toBe('cursor');
|
||||
expect(result.detected).toBe(false);
|
||||
expect(result.indicator).toContain('.cursor');
|
||||
});
|
||||
});
|
||||
|
||||
describe('detectIde — windsurf (directory-based)', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-ide-detect-windsurf-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: .windsurf/ directory present → detected: true
|
||||
test('detected: true when .windsurf/ directory exists', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'with-windsurf');
|
||||
await mkdir(join(projectRoot, '.windsurf'), { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'windsurf');
|
||||
// Assert
|
||||
expect(result.type).toBe('windsurf');
|
||||
expect(result.detected).toBe(true);
|
||||
expect(result.indicator).toContain('.windsurf');
|
||||
});
|
||||
|
||||
// ❌ Negative: .windsurf/ directory absent → detected: false
|
||||
test('detected: false when .windsurf/ directory does not exist', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'without-windsurf');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'windsurf');
|
||||
// Assert
|
||||
expect(result.type).toBe('windsurf');
|
||||
expect(result.detected).toBe(false);
|
||||
expect(result.indicator).toContain('.windsurf');
|
||||
});
|
||||
});
|
||||
|
||||
// ── detectIde — claude (two indicators) ──────────────────────────────────────
|
||||
// Claude is special: it checks for a .claude/ directory OR a CLAUDE.md file.
|
||||
|
||||
describe('detectIde — claude (directory + file indicators)', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-ide-detect-claude-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: .claude/ directory present → detected: true, indicator mentions .claude/
|
||||
test('detected: true when .claude/ directory exists', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'with-claude-dir');
|
||||
await mkdir(join(projectRoot, '.claude'), { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'claude');
|
||||
// Assert
|
||||
expect(result.type).toBe('claude');
|
||||
expect(result.detected).toBe(true);
|
||||
expect(result.indicator).toContain('.claude');
|
||||
});
|
||||
|
||||
// ✅ Positive: CLAUDE.md file present (no directory) → detected: true, indicator mentions CLAUDE.md
|
||||
test('detected: true when CLAUDE.md file exists (no .claude/ directory)', async () => {
|
||||
// Arrange — only the file, no .claude/ directory
|
||||
const projectRoot = join(tmpDir, 'with-claude-file');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
await writeFile(join(projectRoot, 'CLAUDE.md'), '# Claude rules\n', 'utf8');
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'claude');
|
||||
// Assert
|
||||
expect(result.type).toBe('claude');
|
||||
expect(result.detected).toBe(true);
|
||||
expect(result.indicator).toContain('CLAUDE.md');
|
||||
});
|
||||
|
||||
// ✅ Positive: both .claude/ directory and CLAUDE.md present → detected: true
|
||||
test('detected: true when both .claude/ directory and CLAUDE.md exist', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'with-claude-both');
|
||||
await mkdir(join(projectRoot, '.claude'), { recursive: true });
|
||||
await writeFile(join(projectRoot, 'CLAUDE.md'), '# Claude rules\n', 'utf8');
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'claude');
|
||||
// Assert
|
||||
expect(result.type).toBe('claude');
|
||||
expect(result.detected).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: neither .claude/ nor CLAUDE.md present → detected: false
|
||||
test('detected: false when neither .claude/ directory nor CLAUDE.md exists', async () => {
|
||||
// Arrange — empty project root
|
||||
const projectRoot = join(tmpDir, 'without-claude');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const result = await detectIde(projectRoot, 'claude');
|
||||
// Assert
|
||||
expect(result.type).toBe('claude');
|
||||
expect(result.detected).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// ── detectIdes — all 4 IDEs in parallel ──────────────────────────────────────
|
||||
|
||||
describe('detectIdes — parallel detection of all 4 IDEs', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-ide-detect-all-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: returns exactly 4 results covering all IDE types
|
||||
test('returns an array of 4 DetectedIde results', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'count-check');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const results = await detectIdes(projectRoot);
|
||||
// Assert
|
||||
expect(results).toHaveLength(4);
|
||||
const types = results.map((r) => r.type);
|
||||
expect(types).toContain('opencode');
|
||||
expect(types).toContain('cursor');
|
||||
expect(types).toContain('claude');
|
||||
expect(types).toContain('windsurf');
|
||||
});
|
||||
|
||||
// ❌ Negative: empty temp dir → all 4 IDEs return detected: false
|
||||
test('all 4 IDEs return detected: false in an empty directory', async () => {
|
||||
// Arrange — directory with no IDE indicators
|
||||
const projectRoot = join(tmpDir, 'all-absent');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const results = await detectIdes(projectRoot);
|
||||
// Assert
|
||||
for (const result of results) {
|
||||
expect(result.detected).toBe(false);
|
||||
}
|
||||
});
|
||||
|
||||
// ✅ Positive: .cursor/ and CLAUDE.md present → cursor and claude detected, others not
|
||||
test('detects cursor and claude when their indicators are present', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'cursor-and-claude');
|
||||
await mkdir(join(projectRoot, '.cursor'), { recursive: true });
|
||||
await writeFile(join(projectRoot, 'CLAUDE.md'), '# Claude rules\n', 'utf8');
|
||||
// Act
|
||||
const results = await detectIdes(projectRoot);
|
||||
// Assert
|
||||
const byType = Object.fromEntries(results.map((r) => [r.type, r]));
|
||||
expect(byType['cursor']?.detected).toBe(true);
|
||||
expect(byType['claude']?.detected).toBe(true);
|
||||
expect(byType['opencode']?.detected).toBe(false);
|
||||
expect(byType['windsurf']?.detected).toBe(false);
|
||||
});
|
||||
|
||||
// ✅ Positive: all 4 IDE directories present → all 4 detected
|
||||
test('detects all 4 IDEs when all indicator directories are present', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'all-present');
|
||||
await mkdir(join(projectRoot, '.opencode'), { recursive: true });
|
||||
await mkdir(join(projectRoot, '.cursor'), { recursive: true });
|
||||
await mkdir(join(projectRoot, '.claude'), { recursive: true });
|
||||
await mkdir(join(projectRoot, '.windsurf'), { recursive: true });
|
||||
// Act
|
||||
const results = await detectIdes(projectRoot);
|
||||
// Assert
|
||||
for (const result of results) {
|
||||
expect(result.detected).toBe(true);
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
// ── isIdePresent ──────────────────────────────────────────────────────────────
|
||||
|
||||
describe('isIdePresent', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-ide-present-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: returns true when the IDE directory exists
|
||||
test('returns true when .cursor/ directory exists', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'present-cursor');
|
||||
await mkdir(join(projectRoot, '.cursor'), { recursive: true });
|
||||
// Act
|
||||
const present = await isIdePresent(projectRoot, 'cursor');
|
||||
// Assert
|
||||
expect(present).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: returns true for opencode when .opencode/ directory exists
|
||||
test('returns true when .opencode/ directory exists', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'present-opencode');
|
||||
await mkdir(join(projectRoot, '.opencode'), { recursive: true });
|
||||
// Act
|
||||
const present = await isIdePresent(projectRoot, 'opencode');
|
||||
// Assert
|
||||
expect(present).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: returns false when the IDE directory is absent
|
||||
test('returns false when .cursor/ directory does not exist', async () => {
|
||||
// Arrange — empty project root
|
||||
const projectRoot = join(tmpDir, 'absent-cursor');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const present = await isIdePresent(projectRoot, 'cursor');
|
||||
// Assert
|
||||
expect(present).toBe(false);
|
||||
});
|
||||
|
||||
// ❌ Negative: returns false for windsurf when directory is absent
|
||||
test('returns false when .windsurf/ directory does not exist', async () => {
|
||||
// Arrange
|
||||
const projectRoot = join(tmpDir, 'absent-windsurf');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
// Act
|
||||
const present = await isIdePresent(projectRoot, 'windsurf');
|
||||
// Assert
|
||||
expect(present).toBe(false);
|
||||
});
|
||||
|
||||
// ✅ Positive: returns true for claude when CLAUDE.md file exists (no directory)
|
||||
test('returns true for claude when CLAUDE.md file exists', async () => {
|
||||
// Arrange — only the file, no .claude/ directory
|
||||
const projectRoot = join(tmpDir, 'present-claude-file');
|
||||
await mkdir(projectRoot, { recursive: true });
|
||||
await writeFile(join(projectRoot, 'CLAUDE.md'), '# Claude\n', 'utf8');
|
||||
// Act
|
||||
const present = await isIdePresent(projectRoot, 'claude');
|
||||
// Assert
|
||||
expect(present).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: returns false when project root itself does not exist
|
||||
test('returns false when the project root directory does not exist', async () => {
|
||||
// Arrange — a path that was never created
|
||||
const nonExistentRoot = join(tmpDir, 'does-not-exist-at-all');
|
||||
// Act
|
||||
const present = await isIdePresent(nonExistentRoot, 'cursor');
|
||||
// Assert
|
||||
expect(present).toBe(false);
|
||||
});
|
||||
});
|
||||
104
packages/cli/src/lib/ide-detect.ts
Normal file
104
packages/cli/src/lib/ide-detect.ts
Normal file
|
|
@ -0,0 +1,104 @@
|
|||
import path from "node:path";
|
||||
import { stat } from "node:fs/promises";
|
||||
|
||||
// ─── Types ────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type IdeType = "opencode" | "cursor" | "claude" | "windsurf";
|
||||
|
||||
export type DetectedIde = {
|
||||
type: IdeType;
|
||||
detected: boolean;
|
||||
/** Human-readable description of what was found (or checked). */
|
||||
indicator: string;
|
||||
};
|
||||
|
||||
// ─── IDE Definitions ──────────────────────────────────────────────────────────
|
||||
|
||||
/** Maps each IDE to its display name and output file for `oac apply`. */
|
||||
const IDE_DISPLAY_NAMES: Record<IdeType, string> = {
|
||||
opencode: "OpenCode",
|
||||
cursor: "Cursor",
|
||||
claude: "Claude",
|
||||
windsurf: "Windsurf",
|
||||
};
|
||||
|
||||
/** Output file/directory written by `oac apply` for each IDE. */
|
||||
const IDE_OUTPUT_FILES: Record<IdeType, string> = {
|
||||
opencode: ".opencode/",
|
||||
cursor: ".cursorrules",
|
||||
claude: "CLAUDE.md",
|
||||
windsurf: ".windsurfrules",
|
||||
};
|
||||
|
||||
// ─── Detection Logic ──────────────────────────────────────────────────────────
|
||||
|
||||
/** Returns true if `p` is an existing directory. Never throws. */
|
||||
const dirExists = (p: string): Promise<boolean> =>
|
||||
stat(p).then((s) => s.isDirectory()).catch(() => false);
|
||||
|
||||
/** Returns the indicator string and detected status for a single IDE. */
|
||||
async function checkIde(
|
||||
projectRoot: string,
|
||||
ide: IdeType
|
||||
): Promise<{ detected: boolean; indicator: string }> {
|
||||
if (ide === "opencode") {
|
||||
const p = path.join(projectRoot, ".opencode");
|
||||
return (await dirExists(p))
|
||||
? { detected: true, indicator: ".opencode/ directory" }
|
||||
: { detected: false, indicator: ".opencode/ directory (not found)" };
|
||||
}
|
||||
if (ide === "cursor") {
|
||||
const p = path.join(projectRoot, ".cursor");
|
||||
return (await dirExists(p))
|
||||
? { detected: true, indicator: ".cursor/ directory" }
|
||||
: { detected: false, indicator: ".cursor/ directory (not found)" };
|
||||
}
|
||||
if (ide === "claude") {
|
||||
const dir = path.join(projectRoot, ".claude");
|
||||
const file = path.join(projectRoot, "CLAUDE.md");
|
||||
if (await dirExists(dir)) return { detected: true, indicator: ".claude/ directory" };
|
||||
if (await Bun.file(file).exists()) return { detected: true, indicator: "CLAUDE.md file" };
|
||||
return { detected: false, indicator: ".claude/ directory or CLAUDE.md (not found)" };
|
||||
}
|
||||
// windsurf
|
||||
const p = path.join(projectRoot, ".windsurf");
|
||||
return (await dirExists(p))
|
||||
? { detected: true, indicator: ".windsurf/ directory" }
|
||||
: { detected: false, indicator: ".windsurf/ directory (not found)" };
|
||||
}
|
||||
|
||||
// ─── Public API ───────────────────────────────────────────────────────────────
|
||||
|
||||
/** Detects a single IDE in the given project root. */
|
||||
export async function detectIde(
|
||||
projectRoot: string,
|
||||
ide: IdeType
|
||||
): Promise<DetectedIde> {
|
||||
const { detected, indicator } = await checkIde(projectRoot, ide);
|
||||
return { type: ide, detected, indicator };
|
||||
}
|
||||
|
||||
/** Detects all supported IDEs in the given project root. */
|
||||
export async function detectIdes(projectRoot: string): Promise<DetectedIde[]> {
|
||||
const ides: IdeType[] = ["opencode", "cursor", "claude", "windsurf"];
|
||||
return Promise.all(ides.map((ide) => detectIde(projectRoot, ide)));
|
||||
}
|
||||
|
||||
/** Returns true if the given IDE is present in the project root. */
|
||||
export async function isIdePresent(
|
||||
projectRoot: string,
|
||||
ide: IdeType
|
||||
): Promise<boolean> {
|
||||
const result = await detectIde(projectRoot, ide);
|
||||
return result.detected;
|
||||
}
|
||||
|
||||
/** Returns the output file path (relative) written by `oac apply` for an IDE. */
|
||||
export function getIdeOutputFile(ide: IdeType): string {
|
||||
return IDE_OUTPUT_FILES[ide];
|
||||
}
|
||||
|
||||
/** Returns the human-readable display name for an IDE. */
|
||||
export function getIdeDisplayName(ide: IdeType): string {
|
||||
return IDE_DISPLAY_NAMES[ide];
|
||||
}
|
||||
558
packages/cli/src/lib/installer-update.test.ts
Normal file
558
packages/cli/src/lib/installer-update.test.ts
Normal file
|
|
@ -0,0 +1,558 @@
|
|||
/**
|
||||
* Tests for updateFiles() and isProjectRoot() in installer.ts.
|
||||
*
|
||||
* updateFiles() is the core OAC update algorithm:
|
||||
* - File in manifest + hash matches disk → update (overwrite with new bundle version)
|
||||
* - File in manifest + hash differs → skip (user modified it)
|
||||
* - File in manifest + hash differs + yolo → backup + overwrite
|
||||
* - File NOT in manifest → install as new
|
||||
* - File in manifest but NOT in bundle → remove from manifest, leave disk copy
|
||||
*
|
||||
* All tests use real temp directories (no network, no external deps).
|
||||
*/
|
||||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { updateFiles, isProjectRoot } from './installer.js';
|
||||
import { writeManifest, createEmptyManifest, addFileToManifest } from './manifest.js';
|
||||
import { computeFileHash } from './sha256.js';
|
||||
import type { InstallOptions } from './installer.js';
|
||||
import type { FileEntry } from './manifest.js';
|
||||
|
||||
// ── Helpers ───────────────────────────────────────────────────────────────────
|
||||
|
||||
const makeOptions = (
|
||||
projectRoot: string,
|
||||
packageRoot: string,
|
||||
overrides: Partial<InstallOptions> = {},
|
||||
): InstallOptions => ({
|
||||
projectRoot,
|
||||
packageRoot,
|
||||
dryRun: false,
|
||||
yolo: false,
|
||||
verbose: false,
|
||||
...overrides,
|
||||
});
|
||||
|
||||
const makeEntry = (sha256: string, overrides: Partial<FileEntry> = {}): FileEntry => ({
|
||||
sha256,
|
||||
type: 'agent',
|
||||
source: 'bundled',
|
||||
installedAt: new Date().toISOString(),
|
||||
...overrides,
|
||||
});
|
||||
|
||||
/**
|
||||
* Creates a minimal fake package root with a single bundled file.
|
||||
* Returns the relative path used for the bundled file.
|
||||
*/
|
||||
async function setupPackageRoot(
|
||||
packageRoot: string,
|
||||
relativePath: string,
|
||||
content: string,
|
||||
): Promise<void> {
|
||||
const absPath = join(packageRoot, relativePath);
|
||||
await mkdir(join(absPath, '..'), { recursive: true });
|
||||
await writeFile(absPath, content, 'utf8');
|
||||
}
|
||||
|
||||
// ── updateFiles — install new file (not in manifest) ─────────────────────────
|
||||
|
||||
describe('updateFiles — install new file (not in manifest)', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-new-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-new-pkg-'));
|
||||
|
||||
// Bundled file exists in the package
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/new-agent.md', '# New Agent');
|
||||
|
||||
// No manifest written — file is brand new
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: file not in manifest → installed
|
||||
test('installs a file that is not in the manifest', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot);
|
||||
|
||||
// Act
|
||||
const { result, updatedManifest } = await updateFiles(opts);
|
||||
|
||||
// Assert
|
||||
expect(result.installed).toContain('.opencode/agent/new-agent.md');
|
||||
expect(result.errors).toHaveLength(0);
|
||||
expect(result.skipped).toHaveLength(0);
|
||||
|
||||
// File should exist on disk
|
||||
const destPath = join(projectRoot, '.opencode/agent/new-agent.md');
|
||||
expect(await Bun.file(destPath).exists()).toBe(true);
|
||||
expect(await Bun.file(destPath).text()).toBe('# New Agent');
|
||||
|
||||
// Manifest should track the file
|
||||
expect(updatedManifest.files['.opencode/agent/new-agent.md']).toBeDefined();
|
||||
expect(updatedManifest.files['.opencode/agent/new-agent.md']?.sha256).toHaveLength(64);
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — update untouched file (hash matches manifest) ───────────────
|
||||
|
||||
describe('updateFiles — update untouched file (hash matches manifest)', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-untouched-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-untouched-pkg-'));
|
||||
|
||||
// The "old" bundled content that was previously installed
|
||||
const oldContent = '# Old Agent Content';
|
||||
// The "new" bundled content (what the package now ships)
|
||||
const newContent = '# New Agent Content';
|
||||
|
||||
// Write the OLD content to the project (simulating a previous install)
|
||||
const destPath = join(projectRoot, '.opencode/agent/agent.md');
|
||||
await mkdir(join(destPath, '..'), { recursive: true });
|
||||
await writeFile(destPath, oldContent, 'utf8');
|
||||
|
||||
// Compute the hash of the old content (what the manifest recorded)
|
||||
const oldHash = await computeFileHash(destPath);
|
||||
|
||||
// Write a manifest that records the old hash (user hasn't touched the file)
|
||||
let manifest = createEmptyManifest('1.0.0');
|
||||
manifest = addFileToManifest(manifest, '.opencode/agent/agent.md', makeEntry(oldHash));
|
||||
await writeManifest(projectRoot, manifest);
|
||||
|
||||
// Now update the bundled file to the NEW content
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/agent.md', newContent);
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: untouched file → updated with new bundle content
|
||||
test('updates a file whose disk hash matches the manifest (user did not modify it)', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot);
|
||||
|
||||
// Act
|
||||
const { result, updatedManifest } = await updateFiles(opts);
|
||||
|
||||
// Assert
|
||||
expect(result.updated).toContain('.opencode/agent/agent.md');
|
||||
expect(result.skipped).toHaveLength(0);
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// Disk should now have the new content
|
||||
const destPath = join(projectRoot, '.opencode/agent/agent.md');
|
||||
expect(await Bun.file(destPath).text()).toBe('# New Agent Content');
|
||||
|
||||
// Manifest hash should be updated to the new file's hash
|
||||
const newHash = await computeFileHash(destPath);
|
||||
expect(updatedManifest.files['.opencode/agent/agent.md']?.sha256).toBe(newHash);
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — skip user-modified file (no --yolo) ────────────────────────
|
||||
|
||||
describe('updateFiles — skip user-modified file (no --yolo)', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-skip-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-skip-pkg-'));
|
||||
|
||||
// Write a file to disk with content that differs from what the manifest recorded
|
||||
const destPath = join(projectRoot, '.opencode/agent/modified.md');
|
||||
await mkdir(join(destPath, '..'), { recursive: true });
|
||||
await writeFile(destPath, '# User Modified Content', 'utf8');
|
||||
|
||||
// Manifest records a DIFFERENT hash (the original installed hash)
|
||||
const fakeOriginalHash = 'a'.repeat(64); // clearly different from actual file
|
||||
let manifest = createEmptyManifest('1.0.0');
|
||||
manifest = addFileToManifest(manifest, '.opencode/agent/modified.md', makeEntry(fakeOriginalHash));
|
||||
await writeManifest(projectRoot, manifest);
|
||||
|
||||
// Bundle has a new version of the file
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/modified.md', '# Bundle New Content');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: user-modified file → skipped (not overwritten)
|
||||
test('skips a file whose disk hash differs from the manifest (user modified it)', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot, { yolo: false });
|
||||
|
||||
// Act
|
||||
const { result } = await updateFiles(opts);
|
||||
|
||||
// Assert
|
||||
expect(result.skipped).toContain('.opencode/agent/modified.md');
|
||||
expect(result.updated).toHaveLength(0);
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// Disk content must be unchanged
|
||||
const destPath = join(projectRoot, '.opencode/agent/modified.md');
|
||||
expect(await Bun.file(destPath).text()).toBe('# User Modified Content');
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — yolo: backup + overwrite user-modified file ─────────────────
|
||||
|
||||
describe('updateFiles — yolo overwrite of user-modified file', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-yolo-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-yolo-pkg-'));
|
||||
|
||||
// Write user-modified content to disk
|
||||
const destPath = join(projectRoot, '.opencode/agent/yolo-file.md');
|
||||
await mkdir(join(destPath, '..'), { recursive: true });
|
||||
await writeFile(destPath, '# User Modified', 'utf8');
|
||||
|
||||
// Manifest records a different hash
|
||||
const fakeHash = 'b'.repeat(64);
|
||||
let manifest = createEmptyManifest('1.0.0');
|
||||
manifest = addFileToManifest(manifest, '.opencode/agent/yolo-file.md', makeEntry(fakeHash));
|
||||
await writeManifest(projectRoot, manifest);
|
||||
|
||||
// Bundle has new content
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/yolo-file.md', '# Bundle Overwrite');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: yolo mode → file is backed up and overwritten
|
||||
test('backs up and overwrites a user-modified file in yolo mode', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot, { yolo: true });
|
||||
|
||||
// Act
|
||||
const { result } = await updateFiles(opts);
|
||||
|
||||
// Assert — file should be in updated (overwritten) and backed_up
|
||||
expect(result.updated).toContain('.opencode/agent/yolo-file.md');
|
||||
expect(result.backed_up).toHaveLength(1);
|
||||
expect(result.skipped).toHaveLength(0);
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// Disk should now have the bundle content
|
||||
const destPath = join(projectRoot, '.opencode/agent/yolo-file.md');
|
||||
expect(await Bun.file(destPath).text()).toBe('# Bundle Overwrite');
|
||||
|
||||
// Backup should exist and contain the original user content
|
||||
const backupPath = result.backed_up[0]!;
|
||||
expect(await Bun.file(backupPath).exists()).toBe(true);
|
||||
expect(await Bun.file(backupPath).text()).toBe('# User Modified');
|
||||
});
|
||||
|
||||
// ✅ Positive: backup path is inside .oac/backups/
|
||||
test('backup path is inside .oac/backups/', async () => {
|
||||
// The previous test already ran updateFiles; we check the backup path shape.
|
||||
// Re-run with a fresh setup to get a clean result.
|
||||
const pr2 = await mkdtemp(join(tmpdir(), 'oac-yolo-path-'));
|
||||
const pkgr2 = await mkdtemp(join(tmpdir(), 'oac-yolo-path-pkg-'));
|
||||
try {
|
||||
const destPath = join(pr2, '.opencode/agent/path-check.md');
|
||||
await mkdir(join(destPath, '..'), { recursive: true });
|
||||
await writeFile(destPath, '# Modified', 'utf8');
|
||||
const fakeHash = 'c'.repeat(64);
|
||||
let manifest = createEmptyManifest('1.0.0');
|
||||
manifest = addFileToManifest(manifest, '.opencode/agent/path-check.md', makeEntry(fakeHash));
|
||||
await writeManifest(pr2, manifest);
|
||||
await setupPackageRoot(pkgr2, '.opencode/agent/path-check.md', '# New');
|
||||
|
||||
const opts = makeOptions(pr2, pkgr2, { yolo: true });
|
||||
const { result } = await updateFiles(opts);
|
||||
|
||||
expect(result.backed_up[0]).toContain('.oac/backups/');
|
||||
} finally {
|
||||
await rm(pr2, { recursive: true, force: true });
|
||||
await rm(pkgr2, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — dry-run mode ────────────────────────────────────────────────
|
||||
|
||||
describe('updateFiles — dry-run mode', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-dryrun-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-dryrun-pkg-'));
|
||||
|
||||
// Bundle has a file; no manifest, no existing disk file
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/dry-agent.md', '# Dry Agent');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: dry-run reports installed but does not write to disk
|
||||
test('dry-run: reports installed files without writing to disk', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot, { dryRun: true });
|
||||
|
||||
// Act
|
||||
const { result } = await updateFiles(opts);
|
||||
|
||||
// Assert — result says installed
|
||||
expect(result.installed).toContain('.opencode/agent/dry-agent.md');
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// But the file must NOT exist on disk
|
||||
const destPath = join(projectRoot, '.opencode/agent/dry-agent.md');
|
||||
expect(await Bun.file(destPath).exists()).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — remove from manifest (file no longer in bundle) ─────────────
|
||||
|
||||
describe('updateFiles — remove from manifest when file no longer in bundle', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-remove-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-remove-pkg-'));
|
||||
|
||||
// Manifest tracks a file that is no longer in the bundle
|
||||
const oldHash = 'd'.repeat(64);
|
||||
let manifest = createEmptyManifest('1.0.0');
|
||||
manifest = addFileToManifest(manifest, '.opencode/agent/removed.md', makeEntry(oldHash));
|
||||
await writeManifest(projectRoot, manifest);
|
||||
|
||||
// Write the file to disk (user's copy)
|
||||
const destPath = join(projectRoot, '.opencode/agent/removed.md');
|
||||
await mkdir(join(destPath, '..'), { recursive: true });
|
||||
await writeFile(destPath, '# Old File', 'utf8');
|
||||
|
||||
// Bundle does NOT contain this file (packageRoot has no .opencode/agent/removed.md)
|
||||
// But we need at least one bundled file so listBundledFiles returns something
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/current.md', '# Current');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: file removed from bundle → removed from manifest, disk copy untouched
|
||||
test('removes a file from the manifest when it is no longer in the bundle', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot);
|
||||
|
||||
// Act
|
||||
const { result, updatedManifest } = await updateFiles(opts);
|
||||
|
||||
// Assert — removed_from_manifest should contain the old file
|
||||
expect(result.removed_from_manifest).toContain('.opencode/agent/removed.md');
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// Manifest should no longer track the removed file
|
||||
expect(updatedManifest.files['.opencode/agent/removed.md']).toBeUndefined();
|
||||
|
||||
// Disk copy should still exist (we leave user's copy alone)
|
||||
const destPath = join(projectRoot, '.opencode/agent/removed.md');
|
||||
expect(await Bun.file(destPath).exists()).toBe(true);
|
||||
expect(await Bun.file(destPath).text()).toBe('# Old File');
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — file deleted from disk (in manifest, not on disk) ───────────
|
||||
|
||||
describe('updateFiles — reinstall file deleted from disk', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-deleted-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-deleted-pkg-'));
|
||||
|
||||
// Manifest tracks the file, but the file was deleted from disk
|
||||
const fakeHash = 'e'.repeat(64);
|
||||
let manifest = createEmptyManifest('1.0.0');
|
||||
manifest = addFileToManifest(manifest, '.opencode/agent/deleted.md', makeEntry(fakeHash));
|
||||
await writeManifest(projectRoot, manifest);
|
||||
|
||||
// File does NOT exist on disk (user deleted it)
|
||||
// Bundle has the file
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/deleted.md', '# Reinstalled');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: file in manifest but deleted from disk → reinstalled
|
||||
test('reinstalls a file that was deleted from disk (treated as new install)', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot);
|
||||
|
||||
// Act
|
||||
const { result } = await updateFiles(opts);
|
||||
|
||||
// Assert
|
||||
expect(result.installed).toContain('.opencode/agent/deleted.md');
|
||||
expect(result.skipped).toHaveLength(0);
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// File should now exist on disk
|
||||
const destPath = join(projectRoot, '.opencode/agent/deleted.md');
|
||||
expect(await Bun.file(destPath).exists()).toBe(true);
|
||||
expect(await Bun.file(destPath).text()).toBe('# Reinstalled');
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFiles — no manifest (first run) ────────────────────────────────────
|
||||
|
||||
describe('updateFiles — no manifest (first run)', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-update-nomanifest-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-update-nomanifest-pkg-'));
|
||||
|
||||
// Bundle has two files; no manifest exists
|
||||
await setupPackageRoot(packageRoot, '.opencode/agent/a.md', '# Agent A');
|
||||
await setupPackageRoot(packageRoot, '.opencode/context/b.md', '# Context B');
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: no manifest → all bundled files installed as new
|
||||
test('installs all bundled files when no manifest exists', async () => {
|
||||
// Arrange
|
||||
const opts = makeOptions(projectRoot, packageRoot);
|
||||
|
||||
// Act
|
||||
const { result, updatedManifest } = await updateFiles(opts);
|
||||
|
||||
// Assert
|
||||
expect(result.installed).toContain('.opencode/agent/a.md');
|
||||
expect(result.installed).toContain('.opencode/context/b.md');
|
||||
expect(result.installed).toHaveLength(2);
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
// Both files should be tracked in the manifest
|
||||
expect(updatedManifest.files['.opencode/agent/a.md']).toBeDefined();
|
||||
expect(updatedManifest.files['.opencode/context/b.md']).toBeDefined();
|
||||
});
|
||||
});
|
||||
|
||||
// ── isProjectRoot ─────────────────────────────────────────────────────────────
|
||||
|
||||
describe('isProjectRoot', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-projroot-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
// ✅ Positive: directory with package.json is a project root
|
||||
test('returns true for a directory containing package.json', async () => {
|
||||
// Arrange
|
||||
const dir = join(tmpDir, 'has-pkg-json');
|
||||
await mkdir(dir, { recursive: true });
|
||||
await writeFile(join(dir, 'package.json'), '{}', 'utf8');
|
||||
|
||||
// Act
|
||||
const result = await isProjectRoot(dir);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: directory with .git is a project root
|
||||
test('returns true for a directory containing .git', async () => {
|
||||
// Arrange
|
||||
const dir = join(tmpDir, 'has-git');
|
||||
await mkdir(dir, { recursive: true });
|
||||
// Bun.file().exists() checks for files; .git is typically a directory.
|
||||
// The implementation uses Bun.file(path.join(dir, '.git')).exists()
|
||||
// which returns false for directories in Bun. Let's write a .git file
|
||||
// to simulate the check (as the implementation uses Bun.file().exists()).
|
||||
await writeFile(join(dir, '.git'), 'gitdir: ../.git', 'utf8');
|
||||
|
||||
// Act
|
||||
const result = await isProjectRoot(dir);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(true);
|
||||
});
|
||||
|
||||
// ✅ Positive: directory with both package.json and .git is a project root
|
||||
test('returns true for a directory containing both package.json and .git', async () => {
|
||||
// Arrange
|
||||
const dir = join(tmpDir, 'has-both');
|
||||
await mkdir(dir, { recursive: true });
|
||||
await writeFile(join(dir, 'package.json'), '{}', 'utf8');
|
||||
await writeFile(join(dir, '.git'), 'gitdir: ../.git', 'utf8');
|
||||
|
||||
// Act
|
||||
const result = await isProjectRoot(dir);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(true);
|
||||
});
|
||||
|
||||
// ❌ Negative: empty directory is not a project root
|
||||
test('returns false for an empty directory', async () => {
|
||||
// Arrange
|
||||
const dir = join(tmpDir, 'empty-dir');
|
||||
await mkdir(dir, { recursive: true });
|
||||
|
||||
// Act
|
||||
const result = await isProjectRoot(dir);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(false);
|
||||
});
|
||||
|
||||
// ❌ Negative: directory with unrelated files is not a project root
|
||||
test('returns false for a directory with only unrelated files', async () => {
|
||||
// Arrange
|
||||
const dir = join(tmpDir, 'unrelated');
|
||||
await mkdir(dir, { recursive: true });
|
||||
await writeFile(join(dir, 'README.md'), '# Hello', 'utf8');
|
||||
await writeFile(join(dir, 'notes.txt'), 'some notes', 'utf8');
|
||||
|
||||
// Act
|
||||
const result = await isProjectRoot(dir);
|
||||
|
||||
// Assert
|
||||
expect(result).toBe(false);
|
||||
});
|
||||
});
|
||||
198
packages/cli/src/lib/installer.test.ts
Normal file
198
packages/cli/src/lib/installer.test.ts
Normal file
|
|
@ -0,0 +1,198 @@
|
|||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm, writeFile, mkdir } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { installFile, backupFile, installFiles } from './installer.js';
|
||||
import { computeFileHash } from './sha256.js';
|
||||
import type { InstallOptions } from './installer.js';
|
||||
|
||||
// ── Helpers ───────────────────────────────────────────────────────────────────
|
||||
|
||||
const makeOptions = (
|
||||
projectRoot: string,
|
||||
packageRoot: string,
|
||||
overrides: Partial<InstallOptions> = {},
|
||||
): InstallOptions => ({
|
||||
projectRoot,
|
||||
packageRoot,
|
||||
dryRun: false,
|
||||
yolo: false,
|
||||
verbose: false,
|
||||
...overrides,
|
||||
});
|
||||
|
||||
// ── installFile ───────────────────────────────────────────────────────────────
|
||||
|
||||
describe('installFile', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-installer-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
test('copies source file to dest, creating parent dirs', async () => {
|
||||
const srcPath = join(tmpDir, 'source.txt');
|
||||
const destPath = join(tmpDir, 'nested', 'deep', 'dest.txt');
|
||||
await writeFile(srcPath, 'hello installer', 'utf8');
|
||||
|
||||
const opts = makeOptions(tmpDir, tmpDir);
|
||||
await installFile(srcPath, destPath, opts);
|
||||
|
||||
const destFile = Bun.file(destPath);
|
||||
expect(await destFile.exists()).toBe(true);
|
||||
expect(await destFile.text()).toBe('hello installer');
|
||||
});
|
||||
|
||||
test('in dry-run mode, does NOT create the dest file', async () => {
|
||||
const srcPath = join(tmpDir, 'dry-source.txt');
|
||||
const destPath = join(tmpDir, 'dry-dest', 'file.txt');
|
||||
await writeFile(srcPath, 'dry run content', 'utf8');
|
||||
|
||||
const opts = makeOptions(tmpDir, tmpDir, { dryRun: true });
|
||||
await installFile(srcPath, destPath, opts);
|
||||
|
||||
expect(await Bun.file(destPath).exists()).toBe(false);
|
||||
});
|
||||
|
||||
test('overwrites an existing dest file', async () => {
|
||||
const srcPath = join(tmpDir, 'overwrite-src.txt');
|
||||
const destPath = join(tmpDir, 'overwrite-dest.txt');
|
||||
await writeFile(srcPath, 'new content', 'utf8');
|
||||
await writeFile(destPath, 'old content', 'utf8');
|
||||
|
||||
const opts = makeOptions(tmpDir, tmpDir);
|
||||
await installFile(srcPath, destPath, opts);
|
||||
|
||||
expect(await Bun.file(destPath).text()).toBe('new content');
|
||||
});
|
||||
});
|
||||
|
||||
// ── backupFile ────────────────────────────────────────────────────────────────
|
||||
|
||||
describe('backupFile', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-backup-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
test('creates a backup copy and returns its path', async () => {
|
||||
const filePath = join(tmpDir, 'original.txt');
|
||||
await writeFile(filePath, 'backup me', 'utf8');
|
||||
|
||||
const backupPath = await backupFile(filePath, tmpDir);
|
||||
|
||||
expect(await Bun.file(backupPath).exists()).toBe(true);
|
||||
expect(await Bun.file(backupPath).text()).toBe('backup me');
|
||||
});
|
||||
|
||||
test('backup path is inside .oac/backups/', async () => {
|
||||
const filePath = join(tmpDir, 'another.txt');
|
||||
await writeFile(filePath, 'content', 'utf8');
|
||||
|
||||
const backupPath = await backupFile(filePath, tmpDir);
|
||||
|
||||
expect(backupPath).toContain('.oac/backups/');
|
||||
});
|
||||
|
||||
test('original file is unchanged after backup', async () => {
|
||||
const filePath = join(tmpDir, 'unchanged.txt');
|
||||
await writeFile(filePath, 'original content', 'utf8');
|
||||
|
||||
await backupFile(filePath, tmpDir);
|
||||
|
||||
expect(await Bun.file(filePath).text()).toBe('original content');
|
||||
});
|
||||
});
|
||||
|
||||
// ── installFiles (dry-run) ────────────────────────────────────────────────────
|
||||
|
||||
describe('installFiles (dry-run)', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-install-project-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-install-package-'));
|
||||
|
||||
// Create a fake bundled files directory structure
|
||||
await mkdir(join(packageRoot, '.opencode', 'agent'), { recursive: true });
|
||||
await writeFile(
|
||||
join(packageRoot, '.opencode', 'agent', 'test-agent.md'),
|
||||
'# Test Agent',
|
||||
'utf8',
|
||||
);
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
test('dry-run: returns installed list without writing files', async () => {
|
||||
const opts = makeOptions(projectRoot, packageRoot, { dryRun: true });
|
||||
const files = ['.opencode/agent/test-agent.md'];
|
||||
|
||||
const { result } = await installFiles(files, opts);
|
||||
|
||||
// In dry-run, files are "installed" in the result but not on disk
|
||||
expect(result.installed).toContain('.opencode/agent/test-agent.md');
|
||||
expect(result.errors).toHaveLength(0);
|
||||
expect(await Bun.file(join(projectRoot, '.opencode/agent/test-agent.md')).exists()).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// ── installFiles (real write) ─────────────────────────────────────────────────
|
||||
|
||||
describe('installFiles (real write)', () => {
|
||||
let projectRoot: string;
|
||||
let packageRoot: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
projectRoot = await mkdtemp(join(tmpdir(), 'oac-install-real-project-'));
|
||||
packageRoot = await mkdtemp(join(tmpdir(), 'oac-install-real-package-'));
|
||||
|
||||
await mkdir(join(packageRoot, '.opencode', 'context'), { recursive: true });
|
||||
await writeFile(
|
||||
join(packageRoot, '.opencode', 'context', 'standards.md'),
|
||||
'# Standards',
|
||||
'utf8',
|
||||
);
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(projectRoot, { recursive: true, force: true });
|
||||
await rm(packageRoot, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
test('installs files to project root and records sha256', async () => {
|
||||
const opts = makeOptions(projectRoot, packageRoot);
|
||||
const files = ['.opencode/context/standards.md'];
|
||||
|
||||
const { result, updatedManifest } = await installFiles(files, opts);
|
||||
|
||||
expect(result.installed).toContain('.opencode/context/standards.md');
|
||||
expect(result.errors).toHaveLength(0);
|
||||
|
||||
const destPath = join(projectRoot, '.opencode/context/standards.md');
|
||||
expect(await Bun.file(destPath).exists()).toBe(true);
|
||||
expect(await Bun.file(destPath).text()).toBe('# Standards');
|
||||
|
||||
// Manifest entry should have a valid sha256
|
||||
const entry = updatedManifest.files['.opencode/context/standards.md'];
|
||||
expect(entry).toBeDefined();
|
||||
expect(entry?.sha256).toHaveLength(64);
|
||||
|
||||
// sha256 in manifest should match actual file
|
||||
const actualHash = await computeFileHash(destPath);
|
||||
expect(entry?.sha256).toBe(actualHash);
|
||||
});
|
||||
});
|
||||
414
packages/cli/src/lib/installer.ts
Normal file
414
packages/cli/src/lib/installer.ts
Normal file
|
|
@ -0,0 +1,414 @@
|
|||
import path from "node:path";
|
||||
import { stat } from "node:fs/promises";
|
||||
import { computeFileHash, hashesMatch } from "./sha256.js";
|
||||
import {
|
||||
type ManifestFile,
|
||||
type FileEntry,
|
||||
addFileToManifest,
|
||||
removeFileFromManifest,
|
||||
readManifest,
|
||||
createEmptyManifest,
|
||||
} from "./manifest.js";
|
||||
import { listBundledFiles, getBundledFilePath, classifyBundledFile } from "./bundled.js";
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type InstallOptions = {
|
||||
/** Absolute path to the user's project root (where .oac/ lives). */
|
||||
projectRoot: string;
|
||||
/** Absolute path to the OAC npm package root (where bundled files live). */
|
||||
packageRoot: string;
|
||||
/** When true: log what would happen but make no filesystem changes. */
|
||||
dryRun: boolean;
|
||||
/** When true: backup user-modified files and overwrite them. */
|
||||
yolo: boolean;
|
||||
/** When true: emit verbose log lines. */
|
||||
verbose: boolean;
|
||||
};
|
||||
|
||||
export type InstallResult = {
|
||||
/** Relative paths of files newly installed (not previously in manifest). */
|
||||
installed: string[];
|
||||
/** Relative paths of files updated (were untouched by user). */
|
||||
updated: string[];
|
||||
/** Relative paths of files skipped because user modified them. */
|
||||
skipped: string[];
|
||||
/** Relative paths of files backed up before yolo overwrite. */
|
||||
backed_up: string[];
|
||||
/** Relative paths removed from manifest (no longer in bundle). */
|
||||
removed_from_manifest: string[];
|
||||
/** Human-readable error messages for any failures. */
|
||||
errors: string[];
|
||||
};
|
||||
|
||||
// ── Constants ─────────────────────────────────────────────────────────────────
|
||||
|
||||
const EMPTY_RESULT: InstallResult = {
|
||||
installed: [],
|
||||
updated: [],
|
||||
skipped: [],
|
||||
backed_up: [],
|
||||
removed_from_manifest: [],
|
||||
errors: [],
|
||||
};
|
||||
|
||||
// ── Pure helpers ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Builds the ISO timestamp string used in backup directory names. */
|
||||
const buildTimestamp = (): string =>
|
||||
new Date().toISOString().replace(/[:.]/g, "-");
|
||||
|
||||
/** Returns the absolute backup path for a file. */
|
||||
const buildBackupPath = (
|
||||
projectRoot: string,
|
||||
timestamp: string,
|
||||
relativePath: string,
|
||||
): string => path.join(projectRoot, ".oac", "backups", timestamp, relativePath);
|
||||
|
||||
/** Merges a partial result into an existing result (immutable). */
|
||||
const mergeResult = (
|
||||
base: InstallResult,
|
||||
patch: Partial<InstallResult>,
|
||||
): InstallResult => ({
|
||||
installed: [...base.installed, ...(patch.installed ?? [])],
|
||||
updated: [...base.updated, ...(patch.updated ?? [])],
|
||||
skipped: [...base.skipped, ...(patch.skipped ?? [])],
|
||||
backed_up: [...base.backed_up, ...(patch.backed_up ?? [])],
|
||||
removed_from_manifest: [
|
||||
...base.removed_from_manifest,
|
||||
...(patch.removed_from_manifest ?? []),
|
||||
],
|
||||
errors: [...base.errors, ...(patch.errors ?? [])],
|
||||
});
|
||||
|
||||
/** Logs a message when verbose mode is on. Pure side-effect wrapper. */
|
||||
const log = (options: InstallOptions, message: string): void => {
|
||||
if (options.verbose || options.dryRun) {
|
||||
process.stdout.write(`[oac] ${message}\n`);
|
||||
}
|
||||
};
|
||||
|
||||
// ── Single-file I/O operations ────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Copies a single file from `sourcePath` to `destPath`, creating parent
|
||||
* directories as needed. In dry-run mode, logs the action and skips the copy.
|
||||
*/
|
||||
export async function installFile(
|
||||
sourcePath: string,
|
||||
destPath: string,
|
||||
options: InstallOptions,
|
||||
): Promise<void> {
|
||||
if (options.dryRun) {
|
||||
log(options, `[dry-run] would copy: ${sourcePath} → ${destPath}`);
|
||||
return;
|
||||
}
|
||||
await Bun.write(destPath, Bun.file(sourcePath));
|
||||
}
|
||||
|
||||
/**
|
||||
* Backs up `filePath` to `.oac/backups/{timestamp}/{original-relative-path}`.
|
||||
* Returns the absolute backup path. Creates the backup directory if needed.
|
||||
*/
|
||||
export async function backupFile(
|
||||
filePath: string,
|
||||
projectRoot: string,
|
||||
): Promise<string> {
|
||||
const timestamp = buildTimestamp();
|
||||
const relativePath = path.relative(projectRoot, filePath);
|
||||
const backupPath = buildBackupPath(projectRoot, timestamp, relativePath);
|
||||
await Bun.write(backupPath, Bun.file(filePath));
|
||||
return backupPath;
|
||||
}
|
||||
|
||||
// ── Decision logic (pure) ─────────────────────────────────────────────────────
|
||||
|
||||
type FileDecision =
|
||||
| { action: "install" }
|
||||
| { action: "update" }
|
||||
| { action: "skip"; reason: string }
|
||||
| { action: "yolo-overwrite"; backupNeeded: true };
|
||||
|
||||
/**
|
||||
* Determines what action to take for a single bundled file.
|
||||
* Pure — reads from disk but makes no writes.
|
||||
*/
|
||||
async function decideFileAction(
|
||||
relativePath: string,
|
||||
manifest: ManifestFile | null,
|
||||
destPath: string,
|
||||
options: InstallOptions,
|
||||
): Promise<FileDecision> {
|
||||
const manifestEntry = manifest?.files[relativePath];
|
||||
|
||||
// File not in manifest → brand new, always install
|
||||
if (manifestEntry === undefined) {
|
||||
return { action: "install" };
|
||||
}
|
||||
|
||||
// File is in manifest — check if user modified it
|
||||
const diskExists = await Bun.file(destPath).exists();
|
||||
if (!diskExists) {
|
||||
// File was deleted by user — treat as new install
|
||||
return { action: "install" };
|
||||
}
|
||||
|
||||
const currentHash = await computeFileHash(destPath);
|
||||
const isUntouched = hashesMatch(currentHash, manifestEntry.sha256);
|
||||
|
||||
if (isUntouched) {
|
||||
return { action: "update" };
|
||||
}
|
||||
|
||||
// User modified the file
|
||||
if (options.yolo) {
|
||||
return { action: "yolo-overwrite", backupNeeded: true };
|
||||
}
|
||||
|
||||
return {
|
||||
action: "skip",
|
||||
reason: `${relativePath} was modified by user — skipping (use --yolo to overwrite)`,
|
||||
};
|
||||
}
|
||||
|
||||
// ── Per-file processor ────────────────────────────────────────────────────────
|
||||
|
||||
type ProcessFileArgs = {
|
||||
relativePath: string;
|
||||
sourcePath: string;
|
||||
destPath: string;
|
||||
manifest: ManifestFile | null;
|
||||
options: InstallOptions;
|
||||
timestamp: string;
|
||||
};
|
||||
|
||||
/**
|
||||
* Processes a single bundled file: decides the action, performs I/O,
|
||||
* and returns a partial result + updated manifest entry.
|
||||
*/
|
||||
async function processOneFile(
|
||||
args: ProcessFileArgs,
|
||||
): Promise<{ patch: Partial<InstallResult>; entry: FileEntry | null }> {
|
||||
const { relativePath, sourcePath, destPath, manifest, options, timestamp } =
|
||||
args;
|
||||
|
||||
const decisionResult = await (async () => {
|
||||
try {
|
||||
return { ok: true as const, value: await decideFileAction(relativePath, manifest, destPath, options) };
|
||||
} catch (err) {
|
||||
return { ok: false as const, msg: err instanceof Error ? err.message : String(err) };
|
||||
}
|
||||
})();
|
||||
if (!decisionResult.ok) {
|
||||
return {
|
||||
patch: { errors: [`${relativePath}: decision failed — ${decisionResult.msg}`] },
|
||||
entry: null,
|
||||
};
|
||||
}
|
||||
const decision = decisionResult.value;
|
||||
|
||||
const now = new Date().toISOString();
|
||||
const fileType = classifyBundledFile(relativePath);
|
||||
|
||||
try {
|
||||
if (decision.action === "install") {
|
||||
log(options, `install: ${relativePath}`);
|
||||
await installFile(sourcePath, destPath, options);
|
||||
const sha256 = options.dryRun ? "" : await computeFileHash(destPath);
|
||||
const entry: FileEntry = {
|
||||
sha256,
|
||||
type: fileType,
|
||||
source: "bundled",
|
||||
installedAt: now,
|
||||
};
|
||||
return { patch: { installed: [relativePath] }, entry };
|
||||
}
|
||||
|
||||
if (decision.action === "update") {
|
||||
log(options, `update: ${relativePath}`);
|
||||
await installFile(sourcePath, destPath, options);
|
||||
const sha256 = options.dryRun ? "" : await computeFileHash(destPath);
|
||||
const existingEntry = manifest!.files[relativePath]!;
|
||||
const entry: FileEntry = { ...existingEntry, sha256 };
|
||||
return { patch: { updated: [relativePath] }, entry };
|
||||
}
|
||||
|
||||
if (decision.action === "yolo-overwrite") {
|
||||
log(options, `yolo: backing up and overwriting ${relativePath}`);
|
||||
const backupPath = buildBackupPath(options.projectRoot, timestamp, relativePath);
|
||||
if (!options.dryRun) {
|
||||
await Bun.write(backupPath, Bun.file(destPath));
|
||||
} else {
|
||||
log(options, `[dry-run] would backup: ${destPath} → ${backupPath}`);
|
||||
}
|
||||
await installFile(sourcePath, destPath, options);
|
||||
const sha256 = options.dryRun ? "" : await computeFileHash(destPath);
|
||||
const existingEntry = manifest!.files[relativePath]!;
|
||||
const entry: FileEntry = { ...existingEntry, sha256 };
|
||||
return {
|
||||
patch: { backed_up: [backupPath], updated: [relativePath] },
|
||||
entry,
|
||||
};
|
||||
}
|
||||
|
||||
// action === "skip" — TypeScript narrows decision.reason inside this block
|
||||
if (decision.action === "skip") {
|
||||
log(options, `skip: ${decision.reason}`);
|
||||
}
|
||||
return { patch: { skipped: [relativePath] }, entry: null };
|
||||
} catch (err) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
return {
|
||||
patch: { errors: [`${relativePath}: ${msg}`] },
|
||||
entry: null,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
// ── Public API ────────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Installs a list of files from the bundle into the project root.
|
||||
* Does NOT consult the manifest — treats every file as new.
|
||||
* Used by `oac init` for a fresh install.
|
||||
*
|
||||
* Does NOT write the manifest — caller is responsible.
|
||||
*/
|
||||
export async function installFiles(
|
||||
files: string[],
|
||||
options: InstallOptions,
|
||||
): Promise<{ result: InstallResult; updatedManifest: ManifestFile }> {
|
||||
const now = new Date().toISOString();
|
||||
|
||||
type FileOutcome =
|
||||
| { ok: true; relativePath: string; entry: FileEntry }
|
||||
| { ok: false; relativePath: string; msg: string };
|
||||
|
||||
const outcomes = await Promise.all(
|
||||
files.map(async (relativePath): Promise<FileOutcome> => {
|
||||
const sourcePath = getBundledFilePath(options.packageRoot, relativePath);
|
||||
const destPath = path.join(options.projectRoot, relativePath);
|
||||
log(options, `install: ${relativePath}`);
|
||||
try {
|
||||
await installFile(sourcePath, destPath, options);
|
||||
const sha256 = options.dryRun ? "" : await computeFileHash(destPath);
|
||||
const entry: FileEntry = {
|
||||
sha256,
|
||||
type: classifyBundledFile(relativePath),
|
||||
source: "bundled",
|
||||
installedAt: now,
|
||||
};
|
||||
return { ok: true, relativePath, entry };
|
||||
} catch (err) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
return { ok: false, relativePath, msg };
|
||||
}
|
||||
}),
|
||||
);
|
||||
|
||||
const { result, updatedManifest } = outcomes.reduce(
|
||||
(acc, outcome) => {
|
||||
if (outcome.ok) {
|
||||
return {
|
||||
result: mergeResult(acc.result, { installed: [outcome.relativePath] }),
|
||||
updatedManifest: addFileToManifest(acc.updatedManifest, outcome.relativePath, outcome.entry),
|
||||
};
|
||||
}
|
||||
return {
|
||||
result: mergeResult(acc.result, { errors: [`${outcome.relativePath}: ${outcome.msg}`] }),
|
||||
updatedManifest: acc.updatedManifest,
|
||||
};
|
||||
},
|
||||
{ result: { ...EMPTY_RESULT }, updatedManifest: createEmptyManifest("0.0.0") },
|
||||
);
|
||||
|
||||
return { result, updatedManifest };
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements the full OAC update algorithm:
|
||||
*
|
||||
* FOR each file in new bundle:
|
||||
* - In manifest + hash matches disk → safe update
|
||||
* - In manifest + hash differs → skip (or --yolo: backup + overwrite)
|
||||
* - Not in manifest → install as new
|
||||
*
|
||||
* FOR each file in manifest NOT in new bundle:
|
||||
* - Leave user's copy, remove from manifest, warn
|
||||
*
|
||||
* Does NOT write the manifest — caller is responsible.
|
||||
*/
|
||||
export async function updateFiles(
|
||||
options: InstallOptions,
|
||||
): Promise<{ result: InstallResult; updatedManifest: ManifestFile }> {
|
||||
const manifest = await readManifest(options.projectRoot);
|
||||
const bundledFiles = await listBundledFiles(options.packageRoot);
|
||||
const timestamp = buildTimestamp();
|
||||
|
||||
// Phase 1: process each file in the new bundle (parallel)
|
||||
const phase1Results = await Promise.all(
|
||||
bundledFiles.map(async (relativePath) => {
|
||||
const sourcePath = getBundledFilePath(options.packageRoot, relativePath);
|
||||
const destPath = path.join(options.projectRoot, relativePath);
|
||||
const { patch, entry } = await processOneFile({
|
||||
relativePath,
|
||||
sourcePath,
|
||||
destPath,
|
||||
manifest,
|
||||
options,
|
||||
timestamp,
|
||||
});
|
||||
return { relativePath, patch, entry };
|
||||
}),
|
||||
);
|
||||
|
||||
const phase1 = phase1Results.reduce(
|
||||
(acc, { relativePath, patch, entry }) => ({
|
||||
result: mergeResult(acc.result, patch),
|
||||
workingManifest:
|
||||
entry !== null
|
||||
? addFileToManifest(acc.workingManifest, relativePath, entry)
|
||||
: acc.workingManifest,
|
||||
}),
|
||||
{
|
||||
result: { ...EMPTY_RESULT } as InstallResult,
|
||||
workingManifest: manifest ?? createEmptyManifest("0.0.0"),
|
||||
},
|
||||
);
|
||||
|
||||
// Phase 2: handle files in manifest that are no longer in the bundle
|
||||
const bundledSet = new Set(bundledFiles);
|
||||
const manifestPaths = Object.keys(phase1.workingManifest.files);
|
||||
|
||||
const { result, updatedManifest } = manifestPaths.reduce(
|
||||
(acc, trackedPath) => {
|
||||
if (!bundledSet.has(trackedPath)) {
|
||||
process.stdout.write(
|
||||
`[oac] warn: "${trackedPath}" is no longer maintained by OAC — your copy is untouched\n`,
|
||||
);
|
||||
return {
|
||||
result: mergeResult(acc.result, { removed_from_manifest: [trackedPath] }),
|
||||
updatedManifest: removeFileFromManifest(acc.updatedManifest, trackedPath),
|
||||
};
|
||||
}
|
||||
return acc;
|
||||
},
|
||||
{ result: phase1.result, updatedManifest: phase1.workingManifest },
|
||||
);
|
||||
|
||||
return { result, updatedManifest };
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if `dir` contains a `package.json` or `.git` entry.
|
||||
* Used by `oac init` to validate we're operating in a project root.
|
||||
*/
|
||||
export async function isProjectRoot(dir: string): Promise<boolean> {
|
||||
const [hasPackageJson, hasGit] = await Promise.all([
|
||||
Bun.file(path.join(dir, "package.json")).exists(),
|
||||
// stat() works for both files (.git in worktrees) and directories (.git in normal repos)
|
||||
// Bun.file().exists() returns false for directories, so we must use stat() here
|
||||
stat(path.join(dir, ".git")).then(() => true).catch(() => false),
|
||||
]);
|
||||
return hasPackageJson || hasGit;
|
||||
}
|
||||
209
packages/cli/src/lib/manifest.test.ts
Normal file
209
packages/cli/src/lib/manifest.test.ts
Normal file
|
|
@ -0,0 +1,209 @@
|
|||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import {
|
||||
createEmptyManifest,
|
||||
addFileToManifest,
|
||||
removeFileFromManifest,
|
||||
updateFileHash,
|
||||
readManifest,
|
||||
writeManifest,
|
||||
ManifestError,
|
||||
type ManifestFile,
|
||||
type FileEntry,
|
||||
} from './manifest.js';
|
||||
|
||||
// ── Fixtures ──────────────────────────────────────────────────────────────────
|
||||
|
||||
const makeEntry = (overrides: Partial<FileEntry> = {}): FileEntry => ({
|
||||
sha256: 'abc123',
|
||||
type: 'agent',
|
||||
source: 'bundled',
|
||||
installedAt: new Date().toISOString(),
|
||||
...overrides,
|
||||
});
|
||||
|
||||
// ── createEmptyManifest ───────────────────────────────────────────────────────
|
||||
|
||||
describe('createEmptyManifest', () => {
|
||||
test('returns a manifest with version "1"', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
expect(m.version).toBe('1');
|
||||
});
|
||||
|
||||
test('stores the provided oacVersion', () => {
|
||||
const m = createEmptyManifest('2.3.4');
|
||||
expect(m.oacVersion).toBe('2.3.4');
|
||||
});
|
||||
|
||||
test('starts with an empty files record', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
expect(Object.keys(m.files)).toHaveLength(0);
|
||||
});
|
||||
|
||||
test('installedAt and updatedAt are valid ISO strings', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
expect(() => new Date(m.installedAt)).not.toThrow();
|
||||
expect(() => new Date(m.updatedAt)).not.toThrow();
|
||||
});
|
||||
});
|
||||
|
||||
// ── addFileToManifest ─────────────────────────────────────────────────────────
|
||||
|
||||
describe('addFileToManifest', () => {
|
||||
test('adds a new file entry', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
const entry = makeEntry();
|
||||
const updated = addFileToManifest(m, 'agents/foo.md', entry);
|
||||
expect(updated.files['agents/foo.md']).toEqual(entry);
|
||||
});
|
||||
|
||||
test('does not mutate the original manifest', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
addFileToManifest(m, 'agents/foo.md', makeEntry());
|
||||
expect(Object.keys(m.files)).toHaveLength(0);
|
||||
});
|
||||
|
||||
test('replaces an existing entry for the same path', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
const first = makeEntry({ sha256: 'aaa' });
|
||||
const second = makeEntry({ sha256: 'bbb' });
|
||||
const m1 = addFileToManifest(m, 'agents/foo.md', first);
|
||||
const m2 = addFileToManifest(m1, 'agents/foo.md', second);
|
||||
expect(m2.files['agents/foo.md']?.sha256).toBe('bbb');
|
||||
expect(Object.keys(m2.files)).toHaveLength(1);
|
||||
});
|
||||
|
||||
test('updates updatedAt', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
const before = m.updatedAt;
|
||||
// Ensure at least 1ms passes
|
||||
const updated = addFileToManifest(m, 'agents/foo.md', makeEntry());
|
||||
expect(updated.updatedAt >= before).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
// ── removeFileFromManifest ────────────────────────────────────────────────────
|
||||
|
||||
describe('removeFileFromManifest', () => {
|
||||
test('removes an existing file', () => {
|
||||
const m = addFileToManifest(createEmptyManifest('1.0.0'), 'agents/foo.md', makeEntry());
|
||||
const updated = removeFileFromManifest(m, 'agents/foo.md');
|
||||
expect(updated.files['agents/foo.md']).toBeUndefined();
|
||||
});
|
||||
|
||||
test('is a no-op for a path not in the manifest', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
const updated = removeFileFromManifest(m, 'agents/nonexistent.md');
|
||||
expect(Object.keys(updated.files)).toHaveLength(0);
|
||||
});
|
||||
|
||||
test('does not mutate the original manifest', () => {
|
||||
const m = addFileToManifest(createEmptyManifest('1.0.0'), 'agents/foo.md', makeEntry());
|
||||
removeFileFromManifest(m, 'agents/foo.md');
|
||||
expect(m.files['agents/foo.md']).toBeDefined();
|
||||
});
|
||||
|
||||
test('leaves other entries intact', () => {
|
||||
let m = createEmptyManifest('1.0.0');
|
||||
m = addFileToManifest(m, 'agents/a.md', makeEntry());
|
||||
m = addFileToManifest(m, 'agents/b.md', makeEntry());
|
||||
const updated = removeFileFromManifest(m, 'agents/a.md');
|
||||
expect(updated.files['agents/b.md']).toBeDefined();
|
||||
expect(Object.keys(updated.files)).toHaveLength(1);
|
||||
});
|
||||
});
|
||||
|
||||
// ── updateFileHash ────────────────────────────────────────────────────────────
|
||||
|
||||
describe('updateFileHash', () => {
|
||||
test('updates the sha256 of a tracked file', () => {
|
||||
const m = addFileToManifest(createEmptyManifest('1.0.0'), 'agents/foo.md', makeEntry({ sha256: 'old' }));
|
||||
const updated = updateFileHash(m, 'agents/foo.md', 'new-hash');
|
||||
expect(updated.files['agents/foo.md']?.sha256).toBe('new-hash');
|
||||
});
|
||||
|
||||
test('throws ManifestError for an untracked file', () => {
|
||||
const m = createEmptyManifest('1.0.0');
|
||||
expect(() => updateFileHash(m, 'agents/missing.md', 'hash')).toThrow(ManifestError);
|
||||
});
|
||||
|
||||
test('preserves other fields on the entry', () => {
|
||||
const entry = makeEntry({ type: 'context', source: 'registry' });
|
||||
const m = addFileToManifest(createEmptyManifest('1.0.0'), 'ctx/foo.md', entry);
|
||||
const updated = updateFileHash(m, 'ctx/foo.md', 'new-hash');
|
||||
expect(updated.files['ctx/foo.md']?.type).toBe('context');
|
||||
expect(updated.files['ctx/foo.md']?.source).toBe('registry');
|
||||
});
|
||||
});
|
||||
|
||||
// ── ManifestError ─────────────────────────────────────────────────────────────
|
||||
|
||||
describe('ManifestError', () => {
|
||||
test('has name "ManifestError"', () => {
|
||||
const err = new ManifestError('oops');
|
||||
expect(err.name).toBe('ManifestError');
|
||||
});
|
||||
|
||||
test('is an instance of Error', () => {
|
||||
expect(new ManifestError('oops')).toBeInstanceOf(Error);
|
||||
});
|
||||
|
||||
test('carries the message', () => {
|
||||
expect(new ManifestError('bad manifest').message).toBe('bad manifest');
|
||||
});
|
||||
});
|
||||
|
||||
// ── readManifest / writeManifest (I/O) ────────────────────────────────────────
|
||||
|
||||
describe('readManifest / writeManifest', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-manifest-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
test('readManifest returns null when no manifest exists', async () => {
|
||||
const result = await readManifest(tmpDir);
|
||||
expect(result).toBeNull();
|
||||
});
|
||||
|
||||
test('writeManifest then readManifest round-trips correctly', async () => {
|
||||
const original = createEmptyManifest('1.2.3');
|
||||
await writeManifest(tmpDir, original);
|
||||
const read = await readManifest(tmpDir);
|
||||
expect(read).not.toBeNull();
|
||||
expect(read?.version).toBe('1');
|
||||
expect(read?.oacVersion).toBe('1.2.3');
|
||||
expect(Object.keys(read?.files ?? {})).toHaveLength(0);
|
||||
});
|
||||
|
||||
test('readManifest throws ManifestError for invalid JSON structure', async () => {
|
||||
// Write a manifest with a bad version field
|
||||
const badDir = await mkdtemp(join(tmpdir(), 'oac-bad-manifest-'));
|
||||
try {
|
||||
await Bun.write(join(badDir, '.oac/manifest.json'), JSON.stringify({ version: '99', files: {} }));
|
||||
await expect(readManifest(badDir)).rejects.toThrow(ManifestError);
|
||||
} finally {
|
||||
await rm(badDir, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
|
||||
test('round-trips a manifest with file entries', async () => {
|
||||
const dir = await mkdtemp(join(tmpdir(), 'oac-manifest-entries-'));
|
||||
try {
|
||||
let m = createEmptyManifest('1.0.0');
|
||||
m = addFileToManifest(m, '.opencode/agent/foo.md', makeEntry({ type: 'agent' }));
|
||||
await writeManifest(dir, m);
|
||||
const read = await readManifest(dir);
|
||||
expect(read?.files['.opencode/agent/foo.md']?.type).toBe('agent');
|
||||
} finally {
|
||||
await rm(dir, { recursive: true, force: true });
|
||||
}
|
||||
});
|
||||
});
|
||||
178
packages/cli/src/lib/manifest.ts
Normal file
178
packages/cli/src/lib/manifest.ts
Normal file
|
|
@ -0,0 +1,178 @@
|
|||
import path from 'node:path';
|
||||
import { z } from 'zod';
|
||||
|
||||
// ── Errors ────────────────────────────────────────────────────────────────────
|
||||
|
||||
export class ManifestError extends Error {
|
||||
constructor(message: string) {
|
||||
super(message)
|
||||
this.name = 'ManifestError'
|
||||
}
|
||||
}
|
||||
|
||||
// ── Constants ─────────────────────────────────────────────────────────────────
|
||||
|
||||
const MANIFEST_RELATIVE_PATH = '.oac/manifest.json';
|
||||
const MANIFEST_VERSION = '1' as const;
|
||||
|
||||
// ── Schemas ───────────────────────────────────────────────────────────────────
|
||||
|
||||
export const ManifestFileTypeSchema = z.enum([
|
||||
'agent',
|
||||
'context',
|
||||
'skill',
|
||||
'config',
|
||||
'other',
|
||||
]);
|
||||
|
||||
export const FileEntrySchema = z.object({
|
||||
sha256: z.string(),
|
||||
type: ManifestFileTypeSchema,
|
||||
source: z.enum(['bundled', 'registry', 'custom']),
|
||||
installedAt: z.string(),
|
||||
});
|
||||
|
||||
export const ManifestFileSchema = z.object({
|
||||
version: z.literal('1'),
|
||||
oacVersion: z.string(),
|
||||
installedAt: z.string(),
|
||||
updatedAt: z.string(),
|
||||
files: z.record(z.string(), FileEntrySchema),
|
||||
});
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type ManifestFileType = z.infer<typeof ManifestFileTypeSchema>;
|
||||
export type FileEntry = z.infer<typeof FileEntrySchema>;
|
||||
export type ManifestFile = z.infer<typeof ManifestFileSchema>;
|
||||
|
||||
// ── Path helpers ──────────────────────────────────────────────────────────────
|
||||
|
||||
/** Returns the absolute path to the manifest file for a given project root. */
|
||||
export const getManifestPath = (projectRoot: string): string =>
|
||||
path.join(projectRoot, MANIFEST_RELATIVE_PATH);
|
||||
|
||||
// ── Pure constructors ─────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Creates a fresh empty manifest with no installed files.
|
||||
* Pure — no side effects.
|
||||
*/
|
||||
export const createEmptyManifest = (oacVersion: string): ManifestFile => {
|
||||
const now = new Date().toISOString();
|
||||
return {
|
||||
version: MANIFEST_VERSION,
|
||||
oacVersion,
|
||||
installedAt: now,
|
||||
updatedAt: now,
|
||||
files: {},
|
||||
};
|
||||
};
|
||||
|
||||
// ── Pure transformers ─────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Returns a new manifest with the given file entry added or replaced.
|
||||
* Pure — does not mutate the input manifest.
|
||||
*/
|
||||
export const addFileToManifest = (
|
||||
manifest: ManifestFile,
|
||||
filePath: string,
|
||||
entry: FileEntry,
|
||||
): ManifestFile => ({
|
||||
...manifest,
|
||||
updatedAt: new Date().toISOString(),
|
||||
files: {
|
||||
...manifest.files,
|
||||
[filePath]: entry,
|
||||
},
|
||||
});
|
||||
|
||||
/**
|
||||
* Returns a new manifest with the given file entry removed.
|
||||
* Pure — does not mutate the input manifest.
|
||||
* No-op if the file is not present.
|
||||
*/
|
||||
export const removeFileFromManifest = (
|
||||
manifest: ManifestFile,
|
||||
filePath: string,
|
||||
): ManifestFile => {
|
||||
const { [filePath]: _removed, ...remainingFiles } = manifest.files;
|
||||
return {
|
||||
...manifest,
|
||||
updatedAt: new Date().toISOString(),
|
||||
files: remainingFiles,
|
||||
};
|
||||
};
|
||||
|
||||
/**
|
||||
* Returns a new manifest with the SHA256 hash updated for an existing file.
|
||||
* Pure — does not mutate the input manifest.
|
||||
* Throws if the file is not tracked in the manifest.
|
||||
*/
|
||||
export const updateFileHash = (
|
||||
manifest: ManifestFile,
|
||||
filePath: string,
|
||||
sha256: string,
|
||||
): ManifestFile => {
|
||||
const existing = manifest.files[filePath];
|
||||
if (existing === undefined) {
|
||||
throw new ManifestError(
|
||||
`Cannot update hash: "${filePath}" is not tracked in the manifest. ` +
|
||||
`Add it first with addFileToManifest.`,
|
||||
);
|
||||
}
|
||||
return {
|
||||
...manifest,
|
||||
updatedAt: new Date().toISOString(),
|
||||
files: {
|
||||
...manifest.files,
|
||||
[filePath]: { ...existing, sha256 },
|
||||
},
|
||||
};
|
||||
};
|
||||
|
||||
// ── I/O ───────────────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Reads and validates the manifest from {projectRoot}/.oac/manifest.json.
|
||||
* Returns null if the file does not exist.
|
||||
* Throws a ZodError with a clear message if the JSON is present but invalid.
|
||||
*/
|
||||
export const readManifest = async (
|
||||
projectRoot: string,
|
||||
): Promise<ManifestFile | null> => {
|
||||
const manifestPath = getManifestPath(projectRoot);
|
||||
|
||||
const exists = await Bun.file(manifestPath).exists();
|
||||
if (!exists) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const raw: unknown = await Bun.file(manifestPath).json();
|
||||
|
||||
const result = ManifestFileSchema.safeParse(raw);
|
||||
if (!result.success) {
|
||||
const issues = result.error.issues
|
||||
.map((i) => ` • ${i.path.join('.')}: ${i.message}`)
|
||||
.join('\n');
|
||||
throw new ManifestError(
|
||||
`Invalid manifest at ${manifestPath}:\n${issues}\n` +
|
||||
`Run 'oac init' to reset your manifest, or fix the JSON manually.`,
|
||||
);
|
||||
}
|
||||
|
||||
return result.data;
|
||||
};
|
||||
|
||||
/**
|
||||
* Writes the manifest to {projectRoot}/.oac/manifest.json.
|
||||
* Creates the .oac/ directory if it does not exist.
|
||||
*/
|
||||
export const writeManifest = async (
|
||||
projectRoot: string,
|
||||
manifest: ManifestFile,
|
||||
): Promise<void> => {
|
||||
const manifestPath = getManifestPath(projectRoot);
|
||||
await Bun.write(manifestPath, JSON.stringify(manifest, null, 2));
|
||||
};
|
||||
209
packages/cli/src/lib/registry.ts
Normal file
209
packages/cli/src/lib/registry.ts
Normal file
|
|
@ -0,0 +1,209 @@
|
|||
import { z } from "zod";
|
||||
import { join } from "node:path";
|
||||
|
||||
// ── Constants ──────────────────────────────────────────────────────────────────
|
||||
|
||||
const REGISTRY_FILENAME = "registry.json";
|
||||
|
||||
/** Install destinations for each component type (relative to project root). */
|
||||
const INSTALL_DIRS = {
|
||||
agent: ".opencode/agent/",
|
||||
context: ".opencode/context/",
|
||||
skill: ".opencode/skills/",
|
||||
} as const;
|
||||
|
||||
/** Source directories inside the npm bundle for each component type. */
|
||||
const BUNDLE_DIRS = {
|
||||
agent: ".opencode/agent/",
|
||||
context: ".opencode/context/",
|
||||
skill: ".opencode/skills/",
|
||||
} as const;
|
||||
|
||||
// ── Schemas ────────────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* The component types that the CLI can install via `oac add`.
|
||||
* Matches the user-facing ref prefix: `agent:X`, `context:X`, `skill:X`.
|
||||
*/
|
||||
export const ComponentTypeSchema = z.enum(["agent", "context", "skill"]);
|
||||
|
||||
/**
|
||||
* A single installable component entry from registry.json.
|
||||
* The registry also contains subagents, commands, tools, plugins — those are
|
||||
* not user-installable via `oac add` and are excluded from RegistryComponent.
|
||||
*/
|
||||
export const RegistryComponentSchema = z.object({
|
||||
id: z.string(),
|
||||
name: z.string(),
|
||||
type: ComponentTypeSchema,
|
||||
path: z.string(),
|
||||
description: z.string(),
|
||||
tags: z.array(z.string()).default([]),
|
||||
dependencies: z.array(z.string()).default([]),
|
||||
category: z.string().default("standard"),
|
||||
/** Skills may list multiple files to install. */
|
||||
files: z.array(z.string()).optional(),
|
||||
});
|
||||
|
||||
/**
|
||||
* Loose schema for non-installable component categories (subagents, commands,
|
||||
* tools, plugins). We only need to parse them without strict validation.
|
||||
*/
|
||||
const AnyComponentSchema = z.object({
|
||||
id: z.string(),
|
||||
name: z.string(),
|
||||
type: z.string(),
|
||||
path: z.string(),
|
||||
description: z.string(),
|
||||
}).passthrough();
|
||||
|
||||
export const RegistrySchema = z.object({
|
||||
version: z.string(),
|
||||
schema_version: z.string().optional(),
|
||||
repository: z.string().optional(),
|
||||
categories: z.record(z.string(), z.string()).optional(),
|
||||
components: z.object({
|
||||
agents: z.array(RegistryComponentSchema).default([]),
|
||||
skills: z.array(RegistryComponentSchema).default([]),
|
||||
contexts: z.array(RegistryComponentSchema).default([]),
|
||||
// Non-installable sections — parsed loosely so schema changes don't break us
|
||||
subagents: z.array(AnyComponentSchema).default([]),
|
||||
commands: z.array(AnyComponentSchema).default([]),
|
||||
tools: z.array(AnyComponentSchema).default([]),
|
||||
plugins: z.array(AnyComponentSchema).default([]),
|
||||
}),
|
||||
});
|
||||
|
||||
// ── Types ──────────────────────────────────────────────────────────────────────
|
||||
|
||||
export type ComponentType = z.infer<typeof ComponentTypeSchema>;
|
||||
export type RegistryComponent = z.infer<typeof RegistryComponentSchema>;
|
||||
export type Registry = z.infer<typeof RegistrySchema>;
|
||||
|
||||
// ── Path helpers ───────────────────────────────────────────────────────────────
|
||||
|
||||
/** Returns the absolute path to registry.json given the package root. */
|
||||
export const getRegistryPath = (packageRoot: string): string =>
|
||||
join(packageRoot, REGISTRY_FILENAME);
|
||||
|
||||
// ── Pure query helpers ─────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Returns all installable components (agents + skills + contexts) from the
|
||||
* registry, optionally filtered to a single type.
|
||||
* Pure — no side effects.
|
||||
*/
|
||||
export const listComponents = (
|
||||
registry: Registry,
|
||||
type?: ComponentType,
|
||||
): RegistryComponent[] => {
|
||||
const all: RegistryComponent[] = [
|
||||
...registry.components.agents,
|
||||
...registry.components.skills,
|
||||
...registry.components.contexts,
|
||||
];
|
||||
return type === undefined ? all : all.filter((c) => c.type === type);
|
||||
};
|
||||
|
||||
/**
|
||||
* Alias matching the acceptance criteria name.
|
||||
* Filters installable components by type string.
|
||||
* Pure — no side effects.
|
||||
*/
|
||||
export const listComponentsByType = (
|
||||
registry: Registry,
|
||||
type: string,
|
||||
): RegistryComponent[] => {
|
||||
const parsed = ComponentTypeSchema.safeParse(type);
|
||||
if (!parsed.success) return [];
|
||||
return listComponents(registry, parsed.data);
|
||||
};
|
||||
|
||||
/**
|
||||
* Resolves a `type:name` ref (e.g. `"context:react-patterns"`) to a component.
|
||||
* Returns `null` — never throws — when the component is not found or the ref
|
||||
* format is invalid.
|
||||
* Pure — no side effects.
|
||||
*/
|
||||
export const resolveComponent = (
|
||||
registry: Registry,
|
||||
ref: string,
|
||||
): RegistryComponent | null => {
|
||||
const colonIndex = ref.indexOf(":");
|
||||
if (colonIndex === -1) return null;
|
||||
|
||||
const rawType = ref.slice(0, colonIndex);
|
||||
const id = ref.slice(colonIndex + 1);
|
||||
if (!rawType || !id) return null;
|
||||
|
||||
const typeResult = ComponentTypeSchema.safeParse(rawType);
|
||||
if (!typeResult.success) return null;
|
||||
|
||||
const candidates = listComponents(registry, typeResult.data);
|
||||
return candidates.find((c) => c.id === id) ?? null;
|
||||
};
|
||||
|
||||
/**
|
||||
* Returns the directory (relative to project root) where a component should
|
||||
* be installed.
|
||||
* Pure — no side effects.
|
||||
*/
|
||||
export const getInstallPath = (component: RegistryComponent): string =>
|
||||
INSTALL_DIRS[component.type];
|
||||
|
||||
/**
|
||||
* Returns the directory (relative to the npm bundle / package root) where the
|
||||
* component's source files live.
|
||||
* Pure — no side effects.
|
||||
*/
|
||||
export const getBundledSourcePath = (component: RegistryComponent): string =>
|
||||
BUNDLE_DIRS[component.type];
|
||||
|
||||
// ── I/O ────────────────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Reads and validates registry.json from `packageRoot`.
|
||||
* Throws with a clear, actionable message when:
|
||||
* - the file does not exist
|
||||
* - the JSON is malformed
|
||||
* - the schema validation fails
|
||||
*/
|
||||
export const readRegistry = async (packageRoot: string): Promise<Registry> => {
|
||||
const registryPath = getRegistryPath(packageRoot);
|
||||
|
||||
const exists = await Bun.file(registryPath).exists();
|
||||
if (!exists) {
|
||||
throw new Error(
|
||||
`registry.json not found at "${registryPath}".\n` +
|
||||
`This file should be bundled with the @nextsystems/oac package.\n` +
|
||||
`Try reinstalling: npm install -g @nextsystems/oac`,
|
||||
);
|
||||
}
|
||||
|
||||
const raw = await Bun.file(registryPath).json().catch((err: unknown) => {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
throw new Error(
|
||||
`Failed to parse registry.json at "${registryPath}": ${msg}\n` +
|
||||
`The file may be corrupted. Try reinstalling: npm install -g @nextsystems/oac`,
|
||||
);
|
||||
}) as unknown;
|
||||
|
||||
const result = RegistrySchema.safeParse(raw);
|
||||
if (!result.success) {
|
||||
const issues = result.error.issues
|
||||
.map((i) => ` • ${i.path.join(".")}: ${i.message}`)
|
||||
.join("\n");
|
||||
throw new Error(
|
||||
`Invalid registry.json at "${registryPath}":\n${issues}\n` +
|
||||
`The registry schema may have changed. Try reinstalling: npm install -g @nextsystems/oac`,
|
||||
);
|
||||
}
|
||||
|
||||
return result.data;
|
||||
};
|
||||
|
||||
/**
|
||||
* Convenience alias: reads registry.json from `packageRoot`.
|
||||
* Identical to `readRegistry` — provided for callers that prefer this name.
|
||||
*/
|
||||
export const loadRegistry = readRegistry;
|
||||
167
packages/cli/src/lib/sha256.test.ts
Normal file
167
packages/cli/src/lib/sha256.test.ts
Normal file
|
|
@ -0,0 +1,167 @@
|
|||
import { describe, test, expect, beforeAll, afterAll } from 'bun:test';
|
||||
import { mkdtemp, rm, writeFile } from 'node:fs/promises';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { computeFileHash, computeStringHash, hashesMatch } from './sha256.js';
|
||||
|
||||
// ── computeStringHash ─────────────────────────────────────────────────────────
|
||||
|
||||
describe('computeStringHash', () => {
|
||||
test('returns a 64-char hex string', () => {
|
||||
const hash = computeStringHash('hello');
|
||||
expect(hash).toHaveLength(64);
|
||||
expect(hash).toMatch(/^[0-9a-f]{64}$/);
|
||||
});
|
||||
|
||||
test('is deterministic for the same input', () => {
|
||||
expect(computeStringHash('hello')).toBe(computeStringHash('hello'));
|
||||
});
|
||||
|
||||
test('differs for different inputs', () => {
|
||||
expect(computeStringHash('hello')).not.toBe(computeStringHash('world'));
|
||||
});
|
||||
|
||||
test('empty string has a known SHA256', () => {
|
||||
// SHA256('') = e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
|
||||
expect(computeStringHash('')).toBe(
|
||||
'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
|
||||
);
|
||||
});
|
||||
});
|
||||
|
||||
// ── hashesMatch ───────────────────────────────────────────────────────────────
|
||||
|
||||
describe('hashesMatch', () => {
|
||||
test('returns true for identical hashes', () => {
|
||||
const h = computeStringHash('test');
|
||||
expect(hashesMatch(h, h)).toBe(true);
|
||||
});
|
||||
|
||||
test('returns false for different hashes', () => {
|
||||
expect(hashesMatch(computeStringHash('a'), computeStringHash('b'))).toBe(false);
|
||||
});
|
||||
|
||||
test('is case-insensitive', () => {
|
||||
const lower = 'abc123def456';
|
||||
const upper = 'ABC123DEF456';
|
||||
expect(hashesMatch(lower, upper)).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
// ── computeFileHash ───────────────────────────────────────────────────────────
|
||||
|
||||
describe('computeFileHash', () => {
|
||||
let tmpDir: string;
|
||||
|
||||
beforeAll(async () => {
|
||||
tmpDir = await mkdtemp(join(tmpdir(), 'oac-sha256-test-'));
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
await rm(tmpDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
test('returns the SHA256 of a file matching computeStringHash', async () => {
|
||||
const content = 'hello world';
|
||||
const filePath = join(tmpDir, 'test.txt');
|
||||
await writeFile(filePath, content, 'utf8');
|
||||
|
||||
const fileHash = await computeFileHash(filePath);
|
||||
const stringHash = computeStringHash(content);
|
||||
expect(fileHash).toBe(stringHash);
|
||||
});
|
||||
|
||||
test('throws a descriptive error for a missing file', async () => {
|
||||
const missing = join(tmpDir, 'does-not-exist.txt');
|
||||
await expect(computeFileHash(missing)).rejects.toThrow('computeFileHash: cannot read');
|
||||
});
|
||||
|
||||
test('is deterministic across two reads of the same file', async () => {
|
||||
const filePath = join(tmpDir, 'stable.txt');
|
||||
await writeFile(filePath, 'stable content', 'utf8');
|
||||
const h1 = await computeFileHash(filePath);
|
||||
const h2 = await computeFileHash(filePath);
|
||||
expect(h1).toBe(h2);
|
||||
});
|
||||
|
||||
// ✅ Positive: binary file — hash is a valid 64-char hex string
|
||||
test('returns a valid 64-char hex hash for a binary file', async () => {
|
||||
// Arrange — write raw bytes (not valid UTF-8 text)
|
||||
const binaryPath = join(tmpDir, 'binary.bin');
|
||||
const bytes = new Uint8Array([0x00, 0xff, 0xfe, 0x80, 0x01, 0x7f, 0xab, 0xcd]);
|
||||
await Bun.write(binaryPath, bytes);
|
||||
|
||||
// Act
|
||||
const hash = await computeFileHash(binaryPath);
|
||||
|
||||
// Assert
|
||||
expect(hash).toHaveLength(64);
|
||||
expect(hash).toMatch(/^[0-9a-f]{64}$/);
|
||||
});
|
||||
|
||||
// ✅ Positive: binary file hash matches computeStringHash of same bytes
|
||||
test('binary file hash is consistent with hashing the same byte sequence', async () => {
|
||||
// Arrange
|
||||
const binaryPath = join(tmpDir, 'binary-consistent.bin');
|
||||
const bytes = new Uint8Array([0xde, 0xad, 0xbe, 0xef]);
|
||||
await Bun.write(binaryPath, bytes);
|
||||
|
||||
// Act
|
||||
const fileHash = await computeFileHash(binaryPath);
|
||||
// computeStringHash uses utf8 encoding, so we compare against the raw
|
||||
// crypto hash of the same bytes to verify correctness
|
||||
const { createHash } = await import('node:crypto');
|
||||
const expectedHash = createHash('sha256').update(bytes).digest('hex');
|
||||
|
||||
// Assert
|
||||
expect(fileHash).toBe(expectedHash);
|
||||
});
|
||||
|
||||
// ✅ Positive: large file (1 MB) — hash is computed correctly
|
||||
test('returns a valid hash for a large file (1 MB)', async () => {
|
||||
// Arrange — 1 MB of repeated bytes
|
||||
const largePath = join(tmpDir, 'large.bin');
|
||||
const oneMB = 1024 * 1024;
|
||||
const largeBytes = new Uint8Array(oneMB).fill(0x42); // 1 MB of 'B'
|
||||
await Bun.write(largePath, largeBytes);
|
||||
|
||||
// Act
|
||||
const hash = await computeFileHash(largePath);
|
||||
|
||||
// Assert
|
||||
expect(hash).toHaveLength(64);
|
||||
expect(hash).toMatch(/^[0-9a-f]{64}$/);
|
||||
// Verify determinism for large file
|
||||
const hash2 = await computeFileHash(largePath);
|
||||
expect(hash).toBe(hash2);
|
||||
});
|
||||
|
||||
// ❌ Negative: empty file has the known SHA256 of empty content
|
||||
test('empty file returns the SHA256 of empty content', async () => {
|
||||
// Arrange
|
||||
const emptyPath = join(tmpDir, 'empty.txt');
|
||||
await writeFile(emptyPath, '', 'utf8');
|
||||
|
||||
// Act
|
||||
const hash = await computeFileHash(emptyPath);
|
||||
|
||||
// Assert — SHA256('') is the well-known constant
|
||||
expect(hash).toBe('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855');
|
||||
});
|
||||
|
||||
// ❌ Negative: two files with different content have different hashes
|
||||
test('different file contents produce different hashes', async () => {
|
||||
// Arrange
|
||||
const pathA = join(tmpDir, 'diff-a.txt');
|
||||
const pathB = join(tmpDir, 'diff-b.txt');
|
||||
await writeFile(pathA, 'content A', 'utf8');
|
||||
await writeFile(pathB, 'content B', 'utf8');
|
||||
|
||||
// Act
|
||||
const hashA = await computeFileHash(pathA);
|
||||
const hashB = await computeFileHash(pathB);
|
||||
|
||||
// Assert
|
||||
expect(hashA).not.toBe(hashB);
|
||||
});
|
||||
});
|
||||
22
packages/cli/src/lib/sha256.ts
Normal file
22
packages/cli/src/lib/sha256.ts
Normal file
|
|
@ -0,0 +1,22 @@
|
|||
import { createHash } from "node:crypto";
|
||||
|
||||
/** Returns the hex SHA256 of a file's contents. Throws if file does not exist. */
|
||||
export async function computeFileHash(filePath: string): Promise<string> {
|
||||
return Bun.file(filePath)
|
||||
.bytes()
|
||||
.then((contents) => createHash("sha256").update(contents).digest("hex"))
|
||||
.catch((err: unknown) => {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
throw new Error(`computeFileHash: cannot read "${filePath}" — ${msg}`);
|
||||
});
|
||||
}
|
||||
|
||||
/** Returns the hex SHA256 of a string (synchronous). */
|
||||
export function computeStringHash(content: string): string {
|
||||
return createHash("sha256").update(content, "utf8").digest("hex");
|
||||
}
|
||||
|
||||
/** Returns true when two hex SHA256 strings are identical (case-insensitive). */
|
||||
export function hashesMatch(hash1: string, hash2: string): boolean {
|
||||
return hash1.toLowerCase() === hash2.toLowerCase();
|
||||
}
|
||||
19
packages/cli/src/lib/version.test.ts
Normal file
19
packages/cli/src/lib/version.test.ts
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
import { describe, test, expect } from 'bun:test';
|
||||
import { readCliVersion } from './version.js';
|
||||
|
||||
describe('readCliVersion', () => {
|
||||
test('returns a non-empty string', () => {
|
||||
const version = readCliVersion();
|
||||
expect(typeof version).toBe('string');
|
||||
expect(version.length).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
test('matches semver format (x.y.z)', () => {
|
||||
const version = readCliVersion();
|
||||
expect(version).toMatch(/^\d+\.\d+\.\d+/);
|
||||
});
|
||||
|
||||
test('is deterministic across calls', () => {
|
||||
expect(readCliVersion()).toBe(readCliVersion());
|
||||
});
|
||||
});
|
||||
6
packages/cli/src/lib/version.ts
Normal file
6
packages/cli/src/lib/version.ts
Normal file
|
|
@ -0,0 +1,6 @@
|
|||
import pkgJson from '../../package.json' with { type: 'json' }
|
||||
|
||||
/** Returns the CLI version from package.json. Synchronous — no I/O. */
|
||||
export function readCliVersion(): string {
|
||||
return pkgJson.version ?? '0.0.0'
|
||||
}
|
||||
39
packages/cli/src/ui/logger.ts
Normal file
39
packages/cli/src/ui/logger.ts
Normal file
|
|
@ -0,0 +1,39 @@
|
|||
import chalk from 'chalk';
|
||||
|
||||
// ── Types ────────────────────────────────────────────────────────────────────
|
||||
|
||||
export interface Logger {
|
||||
log: (msg: string) => void;
|
||||
info: (msg: string) => void;
|
||||
warn: (msg: string) => void;
|
||||
error: (msg: string) => void;
|
||||
success: (msg: string) => void;
|
||||
dim: (msg: string) => void;
|
||||
bold: (msg: string) => void;
|
||||
verbose: (msg: string) => void;
|
||||
}
|
||||
|
||||
// ── Verbose state (module-local, mutated only via setVerbose) ────────────────
|
||||
|
||||
let verboseEnabled = false;
|
||||
|
||||
export const setVerbose = (enabled: boolean): void => {
|
||||
verboseEnabled = enabled;
|
||||
};
|
||||
|
||||
// ── Output functions (pure aside from console.log side effect) ───────────────
|
||||
|
||||
export const log = (msg: string): void => console.log(msg);
|
||||
export const info = (msg: string): void => console.log(chalk.blue(` ℹ ${msg}`));
|
||||
export const warn = (msg: string): void => console.log(chalk.yellow(` ⚠ ${msg}`));
|
||||
export const error = (msg: string): void => console.error(chalk.red(` ✗ ${msg}`));
|
||||
export const success = (msg: string): void => console.log(chalk.green(` ✓ ${msg}`));
|
||||
export const dim = (msg: string): void => console.log(chalk.gray(msg));
|
||||
export const bold = (msg: string): void => console.log(chalk.bold(msg));
|
||||
export const verbose = (msg: string): void => { if (verboseEnabled) console.log(chalk.gray(` … ${msg}`)); };
|
||||
|
||||
// ── Logger object (aggregates all methods) ───────────────────────────────────
|
||||
// Named `logger` (lowercase) to avoid collision with the `Logger` interface in
|
||||
// the same namespace. Import as: import { logger } from './logger.js'
|
||||
|
||||
export const logger: Logger = { log, info, warn, error, success, dim, bold, verbose };
|
||||
50
packages/cli/src/ui/spinner.ts
Normal file
50
packages/cli/src/ui/spinner.ts
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
import ora, { type Ora } from 'ora';
|
||||
|
||||
// ── Types ─────────────────────────────────────────────────────────────────────
|
||||
|
||||
export interface Spinner {
|
||||
start(text?: string): void;
|
||||
stop(): void;
|
||||
succeed(text?: string): void;
|
||||
fail(text?: string): void;
|
||||
update(text: string): void;
|
||||
}
|
||||
|
||||
export interface SpinnerOptions {
|
||||
/** When true, all spinner methods are no-ops (dry-run mode). */
|
||||
dryRun?: boolean;
|
||||
}
|
||||
|
||||
// ── Global dry-run flag (set once at CLI startup) ─────────────────────────────
|
||||
|
||||
let globalDryRun = false;
|
||||
/** Configure dry-run mode globally. */
|
||||
export const setDryRun = (enabled: boolean): void => { globalDryRun = enabled; };
|
||||
|
||||
// ── Spinner implementations ───────────────────────────────────────────────────
|
||||
|
||||
const noop = (): void => undefined;
|
||||
const createNoOpSpinner = (): Spinner =>
|
||||
({ start: noop, stop: noop, succeed: noop, fail: noop, update: noop });
|
||||
|
||||
const createOraSpinner = (text: string): Spinner => {
|
||||
const s: Ora = ora(text);
|
||||
return {
|
||||
start: (t?: string) => { s.start(t); },
|
||||
stop: () => { s.stop(); },
|
||||
succeed: (t?: string) => { s.succeed(t); },
|
||||
fail: (t?: string) => { s.fail(t); },
|
||||
update: (t: string) => { s.text = t; },
|
||||
};
|
||||
};
|
||||
|
||||
// ── Factory ───────────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* Create a new independent spinner.
|
||||
* Returns a no-op when dry-run mode is active (per options or global flag).
|
||||
*/
|
||||
export const createSpinner = (text: string, options: SpinnerOptions = {}): Spinner => {
|
||||
const isDryRun = options.dryRun ?? globalDryRun;
|
||||
return isDryRun ? createNoOpSpinner() : createOraSpinner(text);
|
||||
};
|
||||
27
packages/cli/tsconfig.json
Normal file
27
packages/cli/tsconfig.json
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2022",
|
||||
"module": "ESNext",
|
||||
"moduleResolution": "bundler",
|
||||
"lib": ["ES2022", "ESNext"],
|
||||
"outDir": "./dist",
|
||||
"rootDir": "./src",
|
||||
"strict": true,
|
||||
"esModuleInterop": true,
|
||||
"skipLibCheck": true,
|
||||
"declaration": true,
|
||||
"declarationMap": true,
|
||||
"sourceMap": true,
|
||||
"resolveJsonModule": true,
|
||||
"allowImportingTsExtensions": false,
|
||||
"noUnusedLocals": true,
|
||||
"noUnusedParameters": true,
|
||||
"noImplicitReturns": true,
|
||||
"noFallthroughCasesInSwitch": true,
|
||||
"paths": {
|
||||
"@openagents-control/compatibility-layer": ["../compatibility-layer/dist/index.d.ts"]
|
||||
}
|
||||
},
|
||||
"include": ["src/**/*"],
|
||||
"exclude": ["node_modules", "dist", "**/*.test.ts"]
|
||||
}
|
||||
Loading…
Reference in a new issue