codeadd 0.1.0 → 0.1.2

package/README.md

@@ -1,34 +1,34 @@
-# pff
+# add
 
-CLI installer for [Product Flow Factory (PFF)](https://github.com/brabos-ai/product-flow-factory).
+CLI installer for [Product Flow Factory (ADD)](https://github.com/brabos-ai/product-flow-factory).
 
 ## Install and run
 
 ```bash
 # interactive install
-npx pff install
+npx add install
 
 # install from main branch
-npx pff install --version main
+npx add install --version main
 
 # install from a specific tag
-npx pff install --version v2.0.1
+npx add install --version v2.0.1
 
 # update installed files to latest release
-npx pff update
+npx add update
 
 # environment checks
-npx pff doctor
+npx add doctor
 
 # integrity checks
-npx pff validate
+npx add validate
 
 # repair integrity issues by restoring from release
-npx pff validate --repair
+npx add validate --repair
 
 # remove installed files
-npx pff uninstall
-npx pff uninstall --force
+npx add uninstall
+npx add uninstall --force
 ```
 
 ## Commands
@@ -37,15 +37,15 @@ npx pff uninstall --force
 - `install --version main`: install from GitHub `main` branch
 - `install --version <tag>`: install from a specific GitHub tag
 - `update`: update installed files to latest GitHub release
-- `doctor`: verify Node, Git, and PFF installation health
-- `validate`: verify file hashes from `.pff/manifest.json`
+- `doctor`: verify Node, Git, and ADD installation health
+- `validate`: verify file hashes from `.add/manifest.json`
 - `validate --repair`: restore missing or modified files
-- `config show`: print current PFF installation config
+- `config show`: print current ADD installation config
 - `config show --verbose`: config + release update check
 
 ## What gets installed
 
-- Core (`.pff/`): always installed
+- Core (`.add/`): always installed
 - Provider integration (optional, selected interactively):
   - Claude Code -> `.claude/`
   - Codex (OpenAI) -> `.agent/`

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "codeadd",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI for Code Addiction framework - AI-powered development workflows",
   "type": "module",
-  "repository": {
+"repository": {
     "type": "git",
     "url": "git+https://github.com/brabos-ai/product-flow-factory.git"
   },

package/src/config.js

@@ -4,12 +4,12 @@ import { intro, outro, spinner, log } from '@clack/prompts';
 import { getLatestTag } from './github.js';
 
 /**
- * Read and parse .pff/manifest.json.
+ * Read and parse .add/manifest.json.
  * @param {string} cwd
  * @returns {{ version: string, releaseTag: string, installedAt: string, providers: string[], files: string[], hashes?: object } | null}
  */
 function readManifest(cwd) {
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
   if (!fs.existsSync(manifestPath)) return null;
   try {
     return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
@@ -45,12 +45,12 @@ function formatDate(isoDate) {
  * @param {boolean} verbose  if true, checks for updates
  */
 export async function config(cwd, verbose = false) {
-  intro('PFF CLI - Config');
+  intro('ADD CLI - Config');
 
   const manifest = readManifest(cwd);
 
   if (!manifest) {
-    outro('ERROR: PFF not installed. Run `npx pff install` first.');
+    outro('ERROR: ADD not installed. Run `npx add install` first.');
     process.exit(1);
   }
 
@@ -82,7 +82,7 @@ export async function config(cwd, verbose = false) {
         log.success('OK You are running the latest version!');
       } else {
         log.warn(`WARN Update available: ${latestTag} (current: ${manifest.releaseTag || manifest.version})`);
-        log.info('   Run `npx pff update` to upgrade.');
+        log.info('   Run `npx add update` to upgrade.');
       }
     } catch (err) {
       s.stop('Update check failed.');

package/src/doctor.js

@@ -42,17 +42,17 @@ function checkGit() {
 }
 
 /**
- * Check if .pff/ directory exists and is non-empty.
+ * Check if .add/ directory exists and is non-empty.
  * @param {string} cwd
  * @returns {{ok: boolean, exists: boolean, hasFiles: boolean}}
  */
-function checkPffDir(cwd) {
-  const pffDir = path.join(cwd, '.pff');
-  const exists = fs.existsSync(pffDir);
+function checkAddDir(cwd) {
+  const addDir = path.join(cwd, '.add');
+  const exists = fs.existsSync(addDir);
   let hasFiles = false;
   if (exists) {
     try {
-      const entries = fs.readdirSync(pffDir);
+      const entries = fs.readdirSync(addDir);
       hasFiles = entries.length > 0;
     } catch {
       // ignore
@@ -71,7 +71,7 @@ function checkPffDir(cwd) {
  * @returns {{ok: boolean, exists: boolean, valid: boolean}}
  */
 function checkManifest(cwd) {
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
   const exists = fs.existsSync(manifestPath);
   let valid = false;
   if (exists) {
@@ -94,14 +94,14 @@ function checkManifest(cwd) {
  * @param {string} cwd
  */
 export async function doctor(cwd) {
-  intro('PFF CLI - Doctor');
+  intro('ADD CLI - Doctor');
 
   const s = spinner();
   s.start('Checking environment...');
 
   const nodeCheck = checkNode();
   const gitCheck = await checkGit();
-  const pffCheck = checkPffDir(cwd);
+  const addCheck = checkAddDir(cwd);
   const manifestCheck = checkManifest(cwd);
 
   s.stop('Checks complete.');
@@ -116,9 +116,9 @@ export async function doctor(cwd) {
   const gitIcon = gitCheck.ok ? 'OK' : 'ERROR';
   log.info(`${gitIcon} Git: ${gitCheck.ok ? gitCheck.version : 'not found'}`);
 
-  const pffIcon = pffCheck.ok ? 'OK' : pffCheck.exists ? 'WARN' : 'ERROR';
-  const pffStatus = pffCheck.ok ? 'present' : pffCheck.exists ? 'empty' : 'missing';
-  log.info(`${pffIcon} .pff/ directory: ${pffStatus}`);
+  const addIcon = addCheck.ok ? 'OK' : addCheck.exists ? 'WARN' : 'ERROR';
+  const addStatus = addCheck.ok ? 'present' : addCheck.exists ? 'empty' : 'missing';
+  log.info(`${addIcon} .add/ directory: ${addStatus}`);
 
   let manifestIcon;
   let manifestStatus;
@@ -136,16 +136,16 @@ export async function doctor(cwd) {
 
   log.info('');
 
-  const allOk = nodeCheck.ok && gitCheck.ok && pffCheck.ok && manifestCheck.ok;
+  const allOk = nodeCheck.ok && gitCheck.ok && addCheck.ok && manifestCheck.ok;
 
   if (allOk) {
-    outro('OK All checks passed! PFF is properly installed.');
+    outro('OK All checks passed! ADD is properly installed.');
     process.exit(0);
   } else {
     const issues = [];
     if (!nodeCheck.ok) issues.push('Node.js >= 18 required');
     if (!gitCheck.ok) issues.push('Git not found');
-    if (!pffCheck.ok) issues.push('.pff/ directory missing or empty');
+    if (!addCheck.ok) issues.push('.add/ directory missing or empty');
     if (!manifestCheck.ok) issues.push('manifest.json missing or invalid');
 
     outro(`ERROR Issues found:\n${issues.map((i) => `  - ${i}`).join('\n')}`);

package/src/github.js

@@ -11,7 +11,7 @@ export async function getLatestTag(repo = REPO) {
   const res = await fetch(url, {
     headers: {
       Accept: 'application/vnd.github+json',
-      'User-Agent': 'pff-cli',
+      'User-Agent': 'add-cli',
     },
   }).catch(() => {
     throw new Error('Could not reach GitHub. Check your connection.');
@@ -37,7 +37,7 @@ export async function getLatestTag(repo = REPO) {
 export async function downloadTagZip(tag, repo = REPO) {
   const url = `https://github.com/${repo}/archive/refs/tags/${tag}.zip`;
   const res = await fetch(url, {
-    headers: { 'User-Agent': 'pff-cli' },
+    headers: { 'User-Agent': 'add-cli' },
   }).catch(() => {
     throw new Error('Could not reach GitHub. Check your connection.');
   });
@@ -64,7 +64,7 @@ export async function downloadTagZip(tag, repo = REPO) {
 export async function downloadBranchZip(branch, repo = REPO) {
   const url = `https://github.com/${repo}/archive/refs/heads/${branch}.zip`;
   const res = await fetch(url, {
-    headers: { 'User-Agent': 'pff-cli' },
+    headers: { 'User-Agent': 'add-cli' },
   }).catch(() => {
     throw new Error('Could not reach GitHub. Check your connection.');
   });

package/src/installer.js

@@ -39,7 +39,7 @@ function calculateHash(filePath) {
 }
 
 /**
- * Write .pff/manifest.json
+ * Write .add/manifest.json
  * @param {string} cwd
  * @param {string} version
  * @param {string[]} providers
@@ -48,7 +48,7 @@ function calculateHash(filePath) {
  * @param {object} [metadata]
  */
 export function writeManifest(cwd, version, providers, files, releaseTag, metadata = {}) {
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
 
   const hashes = {};
   for (const file of files) {
@@ -160,7 +160,7 @@ function dirExists(dir) {
  *
  * @param {AdmZip} zip
  * @param {string} zipRoot   top-level folder name inside zip (e.g. "product-flow-factory-2.0.1")
- * @param {string} srcPrefix path inside zip after zipRoot (e.g. "framwork/.pff")
+ * @param {string} srcPrefix path inside zip after zipRoot (e.g. "framwork/.add")
  * @param {string} destDir   absolute destination directory
  * @param {string} cwd       project root
  * @returns {string[]}
@@ -195,7 +195,7 @@ function copyFromZip(zip, zipRoot, srcPrefix, destDir, cwd) {
  * @param {{version?: string}} [options]
  */
 export async function install(cwd, options = {}) {
-  intro('PFF CLI - Install');
+  intro('ADD CLI - Install');
 
   const s = spinner();
   s.start('Resolving install source from GitHub...');
@@ -208,9 +208,9 @@ export async function install(cwd, options = {}) {
     s.stop(`Selected tag: ${installSource.downloadValue}`);
   }
 
-  const pffDir = path.join(cwd, '.pff');
-  if (dirExists(pffDir)) {
-    await promptConfirm('.pff/ already exists. Overwrite with latest version?');
+  const addDir = path.join(cwd, '.add');
+  if (dirExists(addDir)) {
+    await promptConfirm('.add/ already exists. Overwrite with latest version?');
   }
 
   const selectedKeys = await promptProviders();
@@ -237,7 +237,7 @@ export async function install(cwd, options = {}) {
 
   const allFiles = [];
 
-  const coreFiles = copyFromZip(zip, zipRoot, 'framwork/.pff', pffDir, cwd);
+  const coreFiles = copyFromZip(zip, zipRoot, 'framwork/.add', addDir, cwd);
   allFiles.push(...coreFiles);
 
   for (const p of providers) {
@@ -248,7 +248,7 @@ export async function install(cwd, options = {}) {
 
   s.stop(`Installed ${allFiles.length} files.`);
 
-  fixLineEndings(path.join(pffDir, 'scripts'));
+  fixLineEndings(path.join(addDir, 'scripts'));
 
   writeManifest(
     cwd,
@@ -263,9 +263,9 @@ export async function install(cwd, options = {}) {
   log.success(`Providers installed: ${providerList}`);
 
   outro(
-    `PFF installed successfully!\n\n` +
+    `ADD installed successfully!\n\n` +
       `Next steps:\n` +
-      `  1. Open your AI editor and run: /pff-init\n` +
+      `  1. Open your AI editor and run: /add-init\n` +
       `  2. Follow the onboarding to configure your project\n\n` +
       `Docs: https://github.com/brabos-ai/product-flow-factory`
   );

package/src/uninstaller.js

@@ -3,17 +3,17 @@ import path from 'node:path';
 import { intro, outro, spinner, log } from '@clack/prompts';
 import { promptConfirm } from './prompt.js';
 
-const PFF_DIRS = ['.pff', '.claude', '.agent', '.agents', '.kilocode', '.opencode'];
+const ADD_DIRS = ['.add', '.claude', '.agent', '.agents', '.kilocode', '.opencode'];
 
 /**
- * Read and parse .pff/manifest.json.
+ * Read and parse .add/manifest.json.
  * @param {string} cwd
  * @returns {{ version: string, providers: string[], files: string[], corrupted?: boolean } | null}
  *   Returns null if manifest does not exist.
  *   Returns object with corrupted=true if file exists but JSON is invalid.
  */
 export function readManifest(cwd) {
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
   if (!fs.existsSync(manifestPath)) return null;
   try {
     return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
@@ -72,32 +72,32 @@ function removeEmptyDirs(dir) {
  * @param {boolean} force  skip confirmation
  */
 export async function uninstall(cwd, force = false) {
-  intro('PFF CLI - Uninstall');
+  intro('ADD CLI - Uninstall');
 
   const manifest = readManifest(cwd);
 
   if (!manifest) {
-    throw new Error('No PFF installation found. Run `npx pff install` first.');
+    throw new Error('No ADD installation found. Run `npx add install` first.');
   }
 
   if (manifest.corrupted) {
     log.warn('Manifest is corrupted. Falling back to directory-based removal.');
 
     const allPresent = [];
-    for (const dir of PFF_DIRS) {
+    for (const dir of ADD_DIRS) {
       allPresent.push(...walkDir(path.join(cwd, dir), cwd));
     }
 
     if (allPresent.length === 0) {
-      outro('No PFF files found. Nothing to remove.');
+      outro('No ADD files found. Nothing to remove.');
       return;
     }
 
-    log.info(`Found ${allPresent.length} file(s) in PFF directories.`);
+    log.info(`Found ${allPresent.length} file(s) in ADD directories.`);
 
     if (!force) {
       await promptConfirm(
-        `Remove all ${allPresent.length} files found in PFF directories? This cannot be undone.`
+        `Remove all ${allPresent.length} files found in ADD directories? This cannot be undone.`
       );
     }
 
@@ -117,31 +117,31 @@ export async function uninstall(cwd, force = false) {
     }
     s.stop(`Removed ${removed} files.`);
 
-    for (const dir of PFF_DIRS) {
+    for (const dir of ADD_DIRS) {
       removeEmptyDirs(path.join(cwd, dir));
     }
 
-    outro('PFF removed successfully.');
+    outro('ADD removed successfully.');
     return;
   }
 
   const manifestFiles = new Set(manifest.files ?? []);
 
   const allPresent = [];
-  for (const dir of PFF_DIRS) {
+  for (const dir of ADD_DIRS) {
     allPresent.push(...walkDir(path.join(cwd, dir), cwd));
   }
 
   const userFiles = allPresent.filter((f) => !manifestFiles.has(f));
 
-  log.info(`Files installed by PFF: ${manifestFiles.size}`);
+  log.info(`Files installed by ADD: ${manifestFiles.size}`);
   if (userFiles.length > 0) {
-    log.warn(`Found ${userFiles.length} file(s) not installed by PFF (will be kept):`);
+    log.warn(`Found ${userFiles.length} file(s) not installed by ADD (will be kept):`);
     for (const f of userFiles) log.warn(`  ${f}`);
   }
 
   if (!force) {
-    await promptConfirm(`Remove ${manifestFiles.size} PFF files? (user files will be kept)`);
+    await promptConfirm(`Remove ${manifestFiles.size} ADD files? (user files will be kept)`);
   }
 
   const s = spinner();
@@ -160,7 +160,7 @@ export async function uninstall(cwd, force = false) {
     }
   }
 
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
   try {
     if (fs.existsSync(manifestPath)) {
       fs.unlinkSync(manifestPath);
@@ -172,9 +172,9 @@ export async function uninstall(cwd, force = false) {
 
   s.stop(`Removed ${removed} files.`);
 
-  for (const dir of PFF_DIRS) {
+  for (const dir of ADD_DIRS) {
     removeEmptyDirs(path.join(cwd, dir));
   }
 
-  outro('PFF removed successfully.');
+  outro('ADD removed successfully.');
 }

package/src/updater.js

@@ -59,18 +59,18 @@ function copyFromZip(zip, zipRoot, srcPrefix, destDir, cwd) {
  * @param {string} cwd
  */
 export async function update(cwd) {
-  intro('PFF CLI - Update');
+  intro('ADD CLI - Update');
 
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
   if (!fs.existsSync(manifestPath)) {
-    throw new Error('No PFF installation found. Run `npx pff install` first.');
+    throw new Error('No ADD installation found. Run `npx add install` first.');
   }
 
   let manifest;
   try {
     manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
   } catch {
-    throw new Error('Manifest is corrupted. Run `npx pff install` to reinstall.');
+    throw new Error('Manifest is corrupted. Run `npx add install` to reinstall.');
   }
 
   const currentVersion = manifest.version ?? 'unknown';
@@ -97,9 +97,9 @@ export async function update(cwd) {
   if (!zipRoot) throw new Error('Unexpected zip structure.');
 
   const allFiles = [];
-  const pffDir = path.join(cwd, '.pff');
+  const addDir = path.join(cwd, '.add');
 
-  const coreFiles = copyFromZip(zip, zipRoot, 'framwork/.pff', pffDir, cwd);
+  const coreFiles = copyFromZip(zip, zipRoot, 'framwork/.add', addDir, cwd);
   allFiles.push(...coreFiles);
 
   const providers = resolveSelected(providerKeys);
@@ -111,10 +111,10 @@ export async function update(cwd) {
 
   s.stop(`Updated ${allFiles.length} files.`);
 
-  fixLineEndings(path.join(pffDir, 'scripts'));
+  fixLineEndings(path.join(addDir, 'scripts'));
 
   writeManifest(cwd, tag, providerKeys, allFiles);
 
   log.success(`Updated from v${currentVersion} to v${newVersion}`);
-  outro('PFF updated successfully!');
+  outro('ADD updated successfully!');
 }

package/src/validator.js

@@ -6,12 +6,12 @@ import { intro, outro, spinner, log } from '@clack/prompts';
 import { downloadZip } from './github.js';
 
 /**
- * Read and parse .pff/manifest.json.
+ * Read and parse .add/manifest.json.
  * @param {string} cwd
  * @returns {{ version: string, releaseTag: string, installedAt: string, providers: string[], files: string[], hashes?: object } | null}
  */
 function readManifest(cwd) {
-  const manifestPath = path.join(cwd, '.pff', 'manifest.json');
+  const manifestPath = path.join(cwd, '.add', 'manifest.json');
   if (!fs.existsSync(manifestPath)) return null;
   try {
     return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
@@ -110,19 +110,19 @@ async function repairFiles(cwd, filesToRepair, releaseTag) {
  * @param {boolean} repair  if true, restore missing/modified files
  */
 export async function validate(cwd, repair = false) {
-  intro('PFF CLI - Validate');
+  intro('ADD CLI - Validate');
 
   const manifest = readManifest(cwd);
 
   if (!manifest) {
-    outro('ERROR: PFF not installed. Run `npx pff install` first.');
+    outro('ERROR: ADD not installed. Run `npx add install` first.');
     process.exit(1);
   }
 
   if (!manifest.hashes || Object.keys(manifest.hashes).length === 0) {
     log.warn('');
     log.warn('WARN Hash not available for this install.');
-    log.warn('     Run `npx pff update` to enable validation.');
+    log.warn('     Run `npx add update` to enable validation.');
     log.warn('');
     outro('Validation skipped.');
     process.exit(0);