@givolt/i3-composer-agent 1.0.1 → 2.1.0

package/rebrand/overlay/bin/i3-composer-agent.cjs

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const crypto = require('node:crypto');
-const root = path.resolve(__dirname, '..');
-const pkg = require('../package.json');
-const name = 'i3-composer-agent';
-const args = process.argv.slice(2);
-const identity = `i3 Composer Agent v${pkg.version}\nBased on agent-skills v${pkg.i3ComposerAgent.upstreamVersion}`;
-const help = `${identity}
-${pkg.name}
-
-Install engineering skills with a multi-tool installation wizard.
-
-Usage:
-  npx ${pkg.name}
-  npx ${pkg.name} --codebuddy
-  npx ${pkg.name} --agents codebuddy,codex --scope project --yes
-  npx ${pkg.name} --prepare --claude --dir <directory>
-  npx ${pkg.name} --extract --dir <directory>
-
-Options:
-  --agents <ids>      Comma-separated tool IDs; multiple tools are supported
-  --codebuddy        Preselect CodeBuddy desktop IDE / CodeBuddy Code
-  --codex            Preselect Codex
-  --claude           Preselect Claude Code
-  --scope <scope>    project or global (or use --global / --local)
-  --project-dir <dir> Project installation root (default: current directory)
-  --yes              Confirm explicit noninteractive installation
-  --list-agents      List all supported tool directories
-  --prepare          Prepare a complete plugin for native plugin registration
-  --dir <directory>  Plugin output directory; implies --prepare
-  --dry-run          Show the installation or bundle plan without writing files
-  --force            Replace existing assets, preserving backups
-  --version          Print the package version
-  --help             Show this help
-
-The terminal wizard selects tools and scope, then installs native skill files.
-CodeBuddy and Claude Code also receive short lifecycle commands and personas.
-Other tools receive skills and references; command availability is host-specific.
-Use --prepare for complete plugins, including hooks and host registration.
-`;
-
-function quote(value) { return "'" + value.replaceAll("'", "'\\''") + "'"; }
-function realDestination(target) {
-  let existing = target;
-  const suffix = [];
-  while (!fs.existsSync(existing)) {
-    suffix.unshift(path.basename(existing));
-    const parent = path.dirname(existing);
-    if (parent === existing) throw new Error(`Cannot resolve destination: ${target}`);
-    existing = parent;
-  }
-  return path.join(fs.realpathSync(existing), ...suffix);
-}
-function prepare() {
-  let host;
-  let directory = path.join(process.cwd(), name);
-  let dryRun = false;
-  let force = false;
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '--prepare') continue;
-    if (['--codebuddy', '--codex', '--claude', '--extract'].includes(arg)) {
-      if (host) throw new Error('Choose exactly one host flag or --extract.');
-      host = arg.slice(2);
-    } else if (arg === '--dir') {
-      if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error('--dir requires a directory.');
-      directory = path.resolve(args[++i]);
-    } else if (arg === '--dry-run') dryRun = true;
-    else if (arg === '--force') force = true;
-    else throw new Error(`Unknown option: ${arg}`);
-  }
-  if (!host) throw new Error('Choose --codebuddy, --codex, --claude, or --extract.');
-  directory = realDestination(directory);
-  const sourceRoot = fs.realpathSync(root);
-  if (directory === sourceRoot || directory.startsWith(sourceRoot + path.sep) || sourceRoot.startsWith(directory + path.sep)) {
-    throw new Error('The output directory must be outside this package directory.');
-  }
-  let exists = false;
-  try { fs.lstatSync(directory); exists = true; } catch (error) { if (error.code !== 'ENOENT') throw error; }
-  if (exists) {
-    if (!force) throw new Error(`Output already exists: ${directory}. Choose a new directory or use --force for an i3 bundle.`);
-    const manifest = JSON.parse(fs.readFileSync(path.join(directory, 'plugin.json'), 'utf8'));
-    if (manifest.name !== name) throw new Error('Refusing to replace a directory belonging to another plugin.');
-  }
-  if (dryRun) {
-    console.log(JSON.stringify({ name, version: pkg.version, upstreamVersion: pkg.i3ComposerAgent.upstreamVersion, upstreamCommit: pkg.i3ComposerAgent.upstreamCommit, directory, host, files: pkg.i3ComposerAgent.pluginFiles, replacesExisting: exists }, null, 2));
-    return;
-  }
-  fs.mkdirSync(path.dirname(directory), { recursive: true });
-  const staging = fs.mkdtempSync(path.join(path.dirname(directory), `.${name}-`));
-  let backup;
-  try {
-    for (const relative of pkg.i3ComposerAgent.pluginFiles) {
-      const source = path.join(root, relative);
-      const destination = path.join(staging, relative);
-      fs.mkdirSync(path.dirname(destination), { recursive: true });
-      fs.cpSync(source, destination, {
-        recursive: true,
-        filter: file => {
-          if (path.basename(file) === '.DS_Store') return false;
-          if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`Bundle contains a symlink: ${file}`);
-          return !/(?:^|[\\/])(?:results|node_modules|\.git)(?:[\\/]|$)/.test(path.relative(root, file));
-        },
-      });
-    }
-    if (exists) {
-      backup = `${directory}.backup-${crypto.randomUUID()}`;
-      fs.renameSync(directory, backup);
-    }
-    try { fs.renameSync(staging, directory); }
-    catch (error) { if (backup) fs.renameSync(backup, directory); throw error; }
-  } finally { if (fs.existsSync(staging)) fs.rmSync(staging, { recursive: true, force: true }); }
-  console.log(identity);
-  console.log(`Prepared ${name} at ${directory}`);
-  if (backup) console.log(`Previous bundle preserved at ${backup}`);
-  if (host === 'extract') return;
-  console.log('\nRegister and enable the plugin with these native commands:');
-  const selector = `${name}@${name}`;
-  if (host === 'codex') {
-    console.log(`codex plugin marketplace add ${quote(directory)}`);
-    console.log(`codex plugin add ${selector}`);
-    console.log('Start a new Codex session and invoke the existing skill names. Lifecycle slash-command adaptation is separate.');
-  } else {
-    console.log(`/plugin marketplace add ${quote(directory)}`);
-    console.log(`/plugin install ${selector}`);
-    console.log(`Use /${name}:spec, /${name}:plan, /${name}:build, and /${name}:ship in ${host === 'claude' ? 'Claude Code' : 'CodeBuddy'}.`);
-  }
-}
-async function main() {
-  if (args.includes('--help') || (!args.length && !process.stdin.isTTY)) { console.log(help); return; }
-  if (args.length === 1 && args[0] === '--version') { console.log(pkg.version); return; }
-  if (args.some(arg => ['--extract', '--prepare', '--dir'].includes(arg))) { prepare(); return; }
-  const installer = require('./install.cjs');
-  if (args.length === 1 && args[0] === '--list-agents') {
-    for (const agent of installer.registry.agents) console.log(`${agent.id.padEnd(20)} ${agent.label}${agent.globalSkillsDir ? '' : ' (project only)'}`);
-    return;
-  }
-  const options = { agents: [], projectDir: process.cwd() };
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (['--codebuddy', '--codex', '--claude'].includes(arg)) options.agents.push(arg.slice(2));
-    else if (['--agents', '--scope', '--project-dir'].includes(arg)) {
-      if (!args[i + 1] || args[i + 1].startsWith('--')) throw new Error(`${arg} requires a value.`);
-      const value = args[++i];
-      if (arg === '--agents') options.agents.push(value);
-      else if (arg === '--scope') { if (options.scope && options.scope !== value) throw new Error('Choose one installation scope.'); options.scope = value; }
-      else options.projectDir = path.resolve(value);
-    } else if (arg === '--global' || arg === '--local') {
-      const scope = arg === '--global' ? 'global' : 'project';
-      if (options.scope && options.scope !== scope) throw new Error('Choose one installation scope.');
-      options.scope = scope;
-    } else if (arg === '--yes') options.yes = true;
-    else if (arg === '--force') options.force = true;
-    else if (arg === '--dry-run') options.dryRun = true;
-    else throw new Error(`Unknown option: ${arg}`);
-  }
-  options.agents = installer.selectAgents(options.agents);
-  if (process.stdin.isTTY && process.stdout.isTTY && !options.yes && !options.dryRun) {
-    const selection = await require('./wizard.cjs').choose(options, identity);
-    if (!selection) { console.log('Installation cancelled. No files changed.'); return; }
-    Object.assign(options, selection);
-  } else if (!options.agents.length || !options.scope || (!options.yes && !options.dryRun)) {
-    throw new Error('Use an interactive terminal, or specify --agents <ids> --scope project|global --yes.');
-  }
-  const plan = installer.planInstallation(options);
-  if (options.dryRun) {
-    console.log(JSON.stringify({ name, version: pkg.version, upstreamVersion: pkg.i3ComposerAgent.upstreamVersion, upstreamCommit: pkg.i3ComposerAgent.upstreamCommit, mode: plan.mode, scope: plan.scope, agents: plan.agents, targets: plan.targets, conflicts: plan.conflicts }, null, 2));
-    return;
-  }
-  if (!options.yes) {
-    const confirmed = await require('./wizard.cjs').confirm(plan);
-    if (!confirmed) { console.log('Installation cancelled. No files changed.'); return; }
-    options.force = plan.conflicts.length > 0;
-  }
-  const backups = installer.executeInstallation(plan, { force: options.force });
-  console.log(identity);
-  for (const target of plan.targets) {
-    console.log(`Installed ${target.agents.join(', ')} skills at ${target.skillsDirectory}`);
-    if (target.commandsDirectory) console.log(`Commands: /spec, /plan, /build, /ship (all ${fs.readdirSync(target.commandsDirectory).filter(file => file.endsWith('.md')).length} workflows) at ${target.commandsDirectory}`);
-  }
-  for (const backup of backups) console.log(`Previous assets preserved at ${backup}`);
-  console.log('Reload the IDE window or start a new host session to discover installed files.');
-  if (plan.agents.some(id => !['codebuddy', 'claude-code'].includes(id))) console.log('These tools use the existing skill IDs; lifecycle slash-command support depends on the host.');
-  console.log('Native skill installation does not enable plugin hooks. Use --prepare for complete plugin registration.');
-}
-main().catch(error => { console.error(`${name}: ${error.message}`); process.exitCode = 1; });

package/rebrand/overlay/bin/install.cjs

@@ -1,164 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const os = require('node:os');
-const crypto = require('node:crypto');
-const registry = require('./agent-targets.json');
-const root = path.resolve(__dirname, '..');
-const name = 'i3-composer-agent';
-const aliases = { claude: 'claude-code', gemini: 'gemini-cli', copilot: 'github-copilot' };
-function exists(file) {
-  try { fs.lstatSync(file); return true; }
-  catch (error) { if (error.code === 'ENOENT') return false; throw error; }
-}
-function selectAgents(values) {
-  const ids = [...new Set(values.flatMap(value => value.split(',')).map(id => aliases[id.trim()] || id.trim()).filter(Boolean))];
-  for (const id of ids) if (!registry.agents.some(agent => agent.id === id)) throw new Error(`Unknown tool: ${id}. Use --list-agents.`);
-  return ids;
-}
-function globalSkillsDir(agent, home, env) {
-  const config = agent.globalSkillsDir;
-  if (!config) throw new Error(`${agent.label} supports project installation only. Choose project scope or remove this tool.`);
-  let base = home;
-  if (config.base === 'config') base = env.XDG_CONFIG_HOME && path.isAbsolute(env.XDG_CONFIG_HOME) ? env.XDG_CONFIG_HOME : path.join(home, '.config');
-  if (config.base === 'env') base = env[config.env]?.trim() || path.join(home, config.fallback);
-  if (config.alternatives && !fs.existsSync(path.join(home, path.dirname(config.path)))) {
-    const alternative = config.alternatives.find(relative => fs.existsSync(path.join(home, path.dirname(relative))));
-    if (alternative) return path.join(home, alternative);
-  }
-  return path.resolve(base, config.path);
-}
-// Resolve parent aliases while keeping a leaf symlink replaceable as a link.
-function destination(file) {
-  let parent = path.dirname(file);
-  const suffix = [path.basename(file)];
-  while (!exists(parent)) { suffix.unshift(path.basename(parent)); parent = path.dirname(parent); }
-  return path.join(fs.realpathSync(parent), ...suffix);
-}
-function checkDestination(file) {
-  const source = fs.realpathSync(root);
-  if (file === source || file.startsWith(source + path.sep) || source.startsWith(file + path.sep)) {
-    throw new Error('Installation destinations must be outside this package directory.');
-  }
-}
-function planInstallation({ agents, scope, projectDir = process.cwd(), home = os.homedir(), env = process.env }) {
-  agents = selectAgents(agents);
-  if (!agents.length) throw new Error('Choose at least one tool.');
-  if (!['project', 'global'].includes(scope)) throw new Error('Choose --scope project or --scope global.');
-  const targets = new Map();
-  for (const id of agents) {
-    const agent = registry.agents.find(item => item.id === id);
-    const skillsDirectory = destination(scope === 'project' ? path.resolve(projectDir, agent.projectSkillsDir) : globalSkillsDir(agent, home, env));
-    const base = path.dirname(skillsDirectory);
-    if (!targets.has(skillsDirectory)) targets.set(skillsDirectory, { agents: [], skillsDirectory, referencesDirectory: path.join(base, 'references'), base });
-    const target = targets.get(skillsDirectory);
-    target.agents.push(id);
-    if (['codebuddy', 'claude-code'].includes(id)) {
-      target.commandsDirectory = path.join(base, 'commands');
-      target.personasDirectory = path.join(base, 'agents');
-    }
-  }
-  const assets = [];
-  function addDirectory(sourceDirectory, destinationDirectory, kind) {
-    if (exists(destinationDirectory) && fs.lstatSync(destinationDirectory).isSymbolicLink()) {
-      throw new Error(`Installation directory is a symlink: ${destinationDirectory}. Choose its canonical location instead.`);
-    }
-    for (const entry of fs.readdirSync(path.join(root, sourceDirectory)).sort()) {
-      if (entry === '.DS_Store') continue;
-      assets.push({ source: path.join(root, sourceDirectory, entry), destination: destination(path.join(destinationDirectory, entry)), kind });
-    }
-  }
-  for (const target of targets.values()) {
-    const start = assets.length;
-    addDirectory('skills', target.skillsDirectory, 'skill');
-    addDirectory('references', target.referencesDirectory, 'reference');
-    if (target.commandsDirectory) {
-      addDirectory('.claude/commands', target.commandsDirectory, 'command');
-      addDirectory('agents', target.personasDirectory, 'persona');
-      const docs = path.join(target.base, 'docs');
-      if (exists(docs) && fs.lstatSync(docs).isSymbolicLink()) throw new Error(`Installation directory is a symlink: ${docs}.`);
-      assets.push({ source: path.join(root, 'docs/agents.md'), destination: destination(path.join(target.base, 'docs/agents.md')), kind: 'documentation' });
-    }
-    assets.push({ source: path.join(root, 'LICENSE'), destination: destination(path.join(target.base, `${name}-LICENSE`)), kind: 'attribution' });
-    assets.push({ source: path.join(root, 'NOTICE.md'), destination: destination(path.join(target.base, `${name}-NOTICE.md`)), kind: 'attribution' });
-    assets.push({ target, destination: destination(path.join(target.base, `.${name}.json`)), kind: 'manifest' });
-    for (const asset of assets.slice(start)) {
-      asset.base = target.base;
-      asset.codebuddyCommand = asset.kind === 'command' && target.agents.includes('codebuddy');
-    }
-  }
-  for (const asset of assets) { checkDestination(asset.destination); asset.existing = exists(asset.destination); }
-  return { mode: 'install', scope, agents, targets: [...targets.values()], assets, conflicts: assets.filter(asset => asset.existing).map(asset => asset.destination) };
-}
-function executeInstallation(plan, { force = false } = {}) {
-  if (plan.conflicts.length && !force) throw new Error('Existing installation assets require confirmation or --force; previous files will be backed up.');
-  const pkg = require('../package.json');
-  const contexts = new Map();
-  const createdDirectories = [];
-  const committed = [];
-  function mkdir(directory) {
-    if (exists(directory)) return;
-    mkdir(path.dirname(directory));
-    fs.mkdirSync(directory);
-    createdDirectories.push(directory);
-  }
-  function portable(file, markdown = false, codebuddyCommand = false) {
-    if (fs.statSync(file).isDirectory()) {
-      for (const entry of fs.readdirSync(file)) portable(path.join(file, entry), false, codebuddyCommand);
-    } else if (markdown || file.endsWith('.md')) {
-      let content = fs.readFileSync(file, 'utf8').replaceAll('i3-composer-agent:', '').replaceAll('agent-skills:', '');
-      if (codebuddyCommand) content = content.replaceAll('.claude/agents/', '.codebuddy/agents/');
-      fs.writeFileSync(file, content);
-    }
-  }
-  try {
-    // Stage every target before replacing the first installed asset.
-    for (const [index, asset] of plan.assets.entries()) {
-      if (!contexts.has(asset.base)) {
-        mkdir(asset.base);
-        contexts.set(asset.base, { staging: fs.mkdtempSync(path.join(asset.base, `.${name}-stage-`)), backup: path.join(asset.base, `.${name}-backup-${crypto.randomUUID()}`) });
-      }
-      const context = contexts.get(asset.base);
-      asset.staged = path.join(context.staging, String(index));
-      if (asset.kind === 'manifest') {
-        fs.writeFileSync(asset.staged, JSON.stringify({ name, version: pkg.version, upstreamVersion: pkg.i3ComposerAgent.upstreamVersion, upstreamCommit: pkg.i3ComposerAgent.upstreamCommit, scope: plan.scope, agents: asset.target.agents, assets: plan.assets.filter(item => item.base === asset.base).map(item => path.relative(asset.base, item.destination)) }, null, 2) + '\n');
-      } else {
-        fs.cpSync(asset.source, asset.staged, { recursive: true, filter: file => {
-          if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`Package contains a symlink: ${file}`);
-          return path.basename(file) !== '.DS_Store';
-        } });
-        portable(asset.staged, asset.source.endsWith('.md'), asset.codebuddyCommand);
-      }
-    }
-    for (const asset of plan.assets) {
-      const context = contexts.get(asset.base);
-      mkdir(path.dirname(asset.destination));
-      // A destination may have appeared since planning; never replace it implicitly.
-      if (exists(asset.destination) && !force) throw new Error(`Destination appeared during installation: ${asset.destination}. Retry with confirmed replacement.`);
-      const change = { destination: asset.destination, written: false };
-      if (exists(asset.destination)) {
-        change.backup = path.join(context.backup, path.relative(asset.base, asset.destination));
-        mkdir(path.dirname(change.backup));
-        fs.renameSync(asset.destination, change.backup);
-      }
-      committed.push(change);
-      fs.renameSync(asset.staged, asset.destination);
-      change.written = true;
-    }
-    return [...contexts.values()].map(context => context.backup).filter(exists);
-  } catch (error) {
-    for (const change of committed.reverse()) {
-      if (change.written) fs.rmSync(change.destination, { recursive: true, force: true });
-      if (change.backup) fs.renameSync(change.backup, change.destination);
-    }
-    throw error;
-  } finally {
-    for (const context of contexts.values()) fs.rmSync(context.staging, { recursive: true, force: true });
-    for (const directory of createdDirectories.reverse()) {
-      try { fs.rmdirSync(directory); }
-      catch (error) { if (!['ENOENT', 'ENOTEMPTY', 'EEXIST'].includes(error.code)) throw error; }
-    }
-  }
-}
-module.exports = { registry, selectAgents, planInstallation, executeInstallation, exists };

package/rebrand/overlay/bin/skills-registry.LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Vercel, Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/rebrand/overlay/bin/wizard.cjs

@@ -1,66 +0,0 @@
-'use strict';
-
-const readline = require('node:readline');
-const { registry, selectAgents } = require('./install.cjs');
-
-async function session(action) {
-  const terminal = readline.createInterface({ input: process.stdin, output: process.stdout });
-  let closed = false;
-  terminal.on('close', () => { closed = true; });
-  terminal.on('SIGINT', () => terminal.close());
-  const ask = prompt => new Promise(resolve => {
-    if (closed) { resolve(null); return; }
-    const cancelled = () => resolve(null);
-    terminal.once('close', cancelled);
-    terminal.question(prompt, answer => {
-      terminal.off('close', cancelled);
-      resolve(answer.trim());
-    });
-  });
-  try { return await action(ask); }
-  finally { terminal.close(); }
-}
-async function choose(options, identity) {
-  console.log(identity);
-  console.log('\nChoose tools (multiple selections are supported):');
-  const entries = registry.agents.map((agent, index) => `${index + 1}. ${agent.label} [${agent.id}]${agent.globalSkillsDir ? '' : ' (project only)'}`);
-  for (let index = 0; index < entries.length; index += 2) console.log(entries[index].padEnd(49) + (entries[index + 1] || ''));
-  return session(async ask => {
-    let agents;
-    while (!agents) {
-      const input = await ask(`Select tools by number or ID, comma-separated${options.agents.length ? ` [${options.agents.join(',')}]` : ''} (q cancels): `);
-      if (input === null || ['q', 'cancel'].includes(input.toLowerCase())) return null;
-      try {
-        const values = input === 'all' ? registry.agents.map(agent => agent.id) : input ? input.split(',').map(value => {
-          const trimmed = value.trim();
-          return /^\d+$/.test(trimmed) ? registry.agents[Number(trimmed) - 1]?.id || trimmed : trimmed;
-        }) : options.agents;
-        agents = selectAgents(values);
-        if (!agents.length) { agents = undefined; console.log('Choose at least one tool.'); }
-      } catch (error) { console.log(error.message); }
-    }
-    let scope = options.scope;
-    while (!scope) {
-      const input = await ask('Installation scope: 1. Project (current project), 2. Global (all projects) [1] (q cancels): ');
-      if (input === null || ['q', 'cancel'].includes(input.toLowerCase())) return null;
-      if (['', '1', 'project'].includes(input)) scope = 'project';
-      else if (['2', 'global'].includes(input)) scope = 'global';
-      else console.log('Choose 1 (project) or 2 (global).');
-    }
-    return { agents, scope };
-  });
-}
-async function confirm(plan) {
-  console.log(`\nInstallation scope: ${plan.scope}`);
-  for (const target of plan.targets) {
-    console.log(`  ${target.agents.join(', ')}: ${target.skillsDirectory}`);
-    if (target.commandsDirectory) console.log(`  Commands: ${target.commandsDirectory}`);
-  }
-  if (plan.conflicts.length) console.log(`${plan.conflicts.length} existing assets will be preserved in backups before replacement.`);
-  console.log('Includes all skills and shared references. Plugin hooks require native plugin registration.');
-  return session(async ask => {
-    const answer = await ask('Install these files? [y/N]: ');
-    return answer !== null && ['y', 'yes'].includes(answer.toLowerCase());
-  });
-}
-module.exports = { choose, confirm };

package/rebrand/overlay/scripts/validate-brand.cjs

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const path = require('node:path');
-const root = path.resolve(__dirname, '..');
-const brand = require('../rebrand/brand.json');
-const pkg = require('../package.json');
-const upstream = require('../rebrand/upstream.json');
-const { validateCatalog } = require('../rebrand/catalog.cjs');
-validateCatalog(root, upstream);
-function json(relative) { return JSON.parse(fs.readFileSync(path.join(root, relative), 'utf8')); }
-assert.equal(pkg.name, brand.npmName);
-assert.equal(pkg.version, brand.releaseVersion);
-assert.equal(brand.upstreamCommit, upstream.upstreamCommit);
-assert.equal(pkg.i3ComposerAgent.upstreamVersion, upstream.upstreamVersion);
-assert.equal(pkg.i3ComposerAgent.upstreamCommit, upstream.upstreamCommit);
-assert.equal(pkg.i3ComposerAgent.upstreamRepository, brand.upstream);
-assert.equal(Object.keys(pkg.bin).length, 1, 'npx must resolve one executable');
-assert.ok(fs.existsSync(path.join(root, pkg.bin[brand.name])));
-for (const relative of ['plugin.json', '.claude-plugin/plugin.json', '.codex-plugin/plugin.json']) {
-  assert.equal(json(relative).name, brand.name, `${relative}: inconsistent plugin identity`);
-}
-for (const relative of ['.claude-plugin/marketplace.json', '.agents/plugins/marketplace.json']) {
-  const marketplace = json(relative);
-  assert.equal(marketplace.name, brand.name);
-  assert.equal(marketplace.plugins[0].name, brand.name);
-  assert.ok(marketplace.plugins[0].source === './' || marketplace.plugins[0].source.path === './', 'marketplace must load this distribution');
-}
-assert.ok(json('.codex-plugin/plugin.json').interface.shortDescription.length <= 30);
-const skills = fs.readdirSync(path.join(root, 'skills')).filter(name => fs.existsSync(path.join(root, 'skills', name, 'SKILL.md')));
-assert.equal(skills.length, upstream.skills.length, 'brand conversion must preserve the reviewed upstream skills');
-assert.ok(skills.includes('using-agent-skills'), 'meta-skill ID must remain stable');
-const commands = fs.readdirSync(path.join(root, '.claude/commands')).filter(name => name.endsWith('.md'));
-assert.equal(commands.length, upstream.commands.length, 'brand conversion must preserve the reviewed upstream commands');
-for (const command of commands) {
-  const body = fs.readFileSync(path.join(root, '.claude/commands', command), 'utf8');
-  assert.ok(!body.includes('agent-skills:'), `${command}: stale plugin namespace`);
-  for (const match of body.matchAll(/i3-composer-agent:([a-z-]+)/g)) assert.ok(skills.includes(match[1]), `${command}: unknown skill ${match[1]}`);
-}
-for (const relative of pkg.i3ComposerAgent.pluginFiles) assert.ok(fs.existsSync(path.join(root, relative)), `bundle is missing ${relative}`);
-assert.match(fs.readFileSync(path.join(root, 'LICENSE'), 'utf8'), /Copyright \(c\) 2025 Addy Osmani/);
-console.log('Brand identity, package entrypoint, reviewed upstream catalog, and attribution are consistent.');

package/rebrand/overlay/tests/bundle.test.cjs

@@ -1,85 +0,0 @@
-'use strict';
-
-const test = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const { spawnSync } = require('node:child_process');
-const root = path.resolve(__dirname, '..');
-const upstream = require('../rebrand/upstream.json');
-const cli = path.join(root, 'bin/i3-composer-agent.cjs');
-function run(args) { return spawnSync(process.execPath, [cli, ...args], { encoding: 'utf8' }); }
-function workspace(t) {
-  const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'i3-agent-bundle-'));
-  t.after(() => fs.rmSync(directory, { recursive: true, force: true }));
-  return directory;
-}
-test('help and version identify the package without preparing files', () => {
-  const help = run(['--help']).stdout;
-  assert.match(help, /@givolt\/i3-composer-agent/);
-  assert.ok(help.includes(`i3 Composer Agent v${require('../package.json').version}`));
-  assert.ok(help.includes(`Based on agent-skills v${upstream.upstreamVersion}`));
-  assert.equal(run(['--version']).stdout.trim(), require('../package.json').version);
-});
-test('dry run and invalid arguments leave the target untouched', t => {
-  const target = path.join(workspace(t), 'plugin');
-  assert.equal(run(['--codex', '--dir', target, '--dry-run']).status, 0);
-  assert.equal(fs.existsSync(target), false);
-  assert.equal(run(['--codebuddy', '--codex', '--dir', target]).status, 1);
-  assert.equal(run(['--extract', '--dir']).status, 1);
-  assert.equal(fs.existsSync(target), false);
-});
-test('complete bundle preserves reference links and all host assets at a path with spaces', t => {
-  const target = path.join(workspace(t), 'plugin with spaces');
-  const result = run(['--codebuddy', '--dir', target]);
-  assert.equal(result.status, 0, result.stderr);
-  assert.ok(result.stdout.includes(`i3 Composer Agent v${require('../package.json').version}`));
-  assert.ok(result.stdout.includes(`Based on agent-skills v${upstream.upstreamVersion}`));
-  assert.match(result.stdout, /\/plugin install i3-composer-agent@i3-composer-agent/);
-  assert.equal(fs.readdirSync(path.join(target, 'skills')).length, upstream.skills.length);
-  assert.equal(fs.readdirSync(path.join(target, '.claude/commands')).length, upstream.commands.length);
-  assert.equal(fs.readdirSync(path.join(target, 'agents')).filter(name => name.endsWith('.md')).length, upstream.personas.length);
-  assert.equal(JSON.parse(fs.readFileSync(path.join(target, '.codex-plugin/plugin.json'), 'utf8')).name, 'i3-composer-agent');
-  const check = spawnSync(process.execPath, [path.join(target, 'scripts/validate-reference-links.js')], { cwd: target, encoding: 'utf8' });
-  assert.equal(check.status, 0, check.stdout + check.stderr);
-  assert.equal(fs.existsSync(path.join(target, 'AGENTS.md')), false);
-  assert.equal(fs.existsSync(path.join(target, 'CLAUDE.md')), false);
-});
-test('existing unrelated files cannot be replaced even with force', t => {
-  const target = path.join(workspace(t), 'existing');
-  fs.mkdirSync(target);
-  fs.writeFileSync(path.join(target, 'plugin.json'), '{"name":"another-plugin"}\n');
-  fs.writeFileSync(path.join(target, 'keep.txt'), 'business data');
-  assert.equal(run(['--extract', '--dir', target]).status, 1);
-  assert.equal(run(['--extract', '--dir', target, '--force']).status, 1);
-  assert.equal(fs.readFileSync(path.join(target, 'keep.txt'), 'utf8'), 'business data');
-});
-test('installed packages beneath node_modules remain fully extractable', t => {
-  const parent = workspace(t);
-  const installed = path.join(parent, 'node_modules', '@givolt', 'i3-composer-agent');
-  assert.equal(run(['--extract', '--dir', installed]).status, 0);
-  const target = path.join(parent, 'plugin');
-  const result = spawnSync(process.execPath, [path.join(installed, 'bin/i3-composer-agent.cjs'), '--extract', '--dir', target], { encoding: 'utf8' });
-  assert.equal(result.status, 0, result.stderr);
-  assert.equal(JSON.parse(fs.readFileSync(path.join(target, 'package.json'), 'utf8')).name, '@givolt/i3-composer-agent');
-  assert.equal(fs.readdirSync(path.join(target, 'skills')).length, upstream.skills.length);
-});
-test('replacement preserves the complete previous bundle in a backup', t => {
-  const parent = workspace(t);
-  const target = path.join(parent, 'plugin');
-  assert.equal(run(['--extract', '--dir', target]).status, 0);
-  fs.writeFileSync(path.join(target, 'custom-note.txt'), 'preserve me');
-  const result = run(['--extract', '--dir', target, '--force']);
-  assert.equal(result.status, 0, result.stderr);
-  const backups = fs.readdirSync(parent).filter(name => name.startsWith('plugin.backup-'));
-  assert.equal(backups.length, 1);
-  assert.equal(fs.readFileSync(path.join(parent, backups[0], 'custom-note.txt'), 'utf8'), 'preserve me');
-  assert.equal(fs.existsSync(path.join(target, 'custom-note.txt')), false);
-});
-test('source directories and aliases cannot be overwritten', t => {
-  assert.equal(run(['--extract', '--dir', root, '--force']).status, 1);
-  const alias = path.join(workspace(t), 'source-alias');
-  fs.symlinkSync(root, alias, 'dir');
-  assert.equal(run(['--extract', '--dir', alias, '--force']).status, 1);
-});