@mobiman/vector 1.1.3 → 1.1.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Lex Christopherson
+Copyright (c) 2025 Steven Becerra
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,12 +1,18 @@
 <div align="center">
 
 # Vector
-**A meta-prompting, context engineering, and spec-driven development system for iOS app creation**
+**An open-source spec-driven system for building mobile apps with Claude**
+
+[![npm](https://img.shields.io/npm/v/@mobiman/vector)](https://www.npmjs.com/package/@mobiman/vector)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Discord](https://img.shields.io/discord/rkU8UTu7dY?label=Discord&logo=discord&logoColor=white)](https://discord.gg/rkU8UTu7dY)
+
+---
 
 ## Getting Started
 
 ```bash
-npx vector@latest
+npx @mobiman/vector
 ```
 
 <br>
@@ -111,3 +117,15 @@ The orchestrator never does heavy lifting. It spawns agents, waits, integrates r
 | `/vector:health [--repair]` | Validate `.planning/` directory integrity, auto-repair with `--repair` |
 | `/vector:stats` | Display project statistics — phases, plans, requirements, git metrics |
 
+## Community
+
+- [Discord](https://discord.gg/rkU8UTu7dY) — get help, share what you're building, give feedback
+- [Issues](https://github.com/mobiman1/vector/issues) — bug reports and feature requests
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting bug reports, feature requests, and pull requests.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

package/bin/install.cjs

@@ -16,11 +16,13 @@ const green = '\x1b[32m';
 const yellow = '\x1b[33m';
 const dim = '\x1b[2m';
 const reset = '\x1b[0m';
+const bold = '\x1b[1m';
+const purple = '\x1b[38;5;135m';
 // Codex config.toml constants
-const GSD_CODEX_MARKER = '# Vector Agent Configuration \u2014 managed by core installer';
+const VECTOR_CODEX_MARKER = '# Vector Agent Configuration \u2014 managed by core installer';
 // Copilot instructions marker constants
-const GSD_COPILOT_INSTRUCTIONS_MARKER = '<!-- Vector Configuration \u2014 managed by core installer -->';
-const GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER = '<!-- /Vector Configuration -->';
+const VECTOR_COPILOT_INSTRUCTIONS_MARKER = '<!-- Vector Configuration \u2014 managed by core installer -->';
+const VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER = '<!-- /Vector Configuration -->';
 const CODEX_AGENT_SANDBOX = {
     'vector-executor': 'workspace-write',
     'vector-planner': 'workspace-write',
@@ -248,16 +250,10 @@ function getGlobalDir(runtime, explicitDir = null) {
     return path_1.default.join(os_1.default.homedir(), '.claude');
 }
 const banner = '\n' +
-    cyan + '    \\          /────▶\n' +
-    '     \\        /\n' +
-    '      \\      /\n' +
-    '       \\    /\n' +
-    '        \\  /\n' +
-    '         \\/' + reset + '\n' +
+    bold + purple + '  ＶＥＣＴＯＲ' + reset + dim + '   by Mobiman' + reset + '\n' +
     '\n' +
-    '  Vector ' + dim + 'v' + package_json_1.default.version + reset + '\n' +
-    '  A meta-prompting, context engineering, and spec-driven\n' +
-    '  development system for iOS app creation by Mobiman\n';
+    dim + '  v' + package_json_1.default.version + reset + '\n' +
+    '  An open-source spec-driven system for building mobile apps with Claude\n';
 // Parse --config-dir argument
 function parseConfigDirArg() {
     const configDirIndex = args.findIndex(arg => arg === '--config-dir' || arg === '-c');
@@ -805,7 +801,7 @@ function generateCodexAgentToml(agentName, agentContent) {
  */
 function generateCodexConfigBlock(agents) {
     const lines = [
-        GSD_CODEX_MARKER,
+        VECTOR_CODEX_MARKER,
         '',
     ];
     for (const { name, description } of agents) {
@@ -820,8 +816,8 @@ function generateCodexConfigBlock(agents) {
  * Strip Vector sections from Codex config.toml content.
  * Returns cleaned content, or null if file would be empty.
  */
-function stripGsdFromCodexConfig(content) {
-    const markerIndex = content.indexOf(GSD_CODEX_MARKER);
+function stripVectorFromCodexConfig(content) {
+    const markerIndex = content.indexOf(VECTOR_CODEX_MARKER);
     if (markerIndex !== -1) {
         // Has Vector marker — remove everything from marker to EOF
         let before = content.substring(0, markerIndex).trimEnd();
@@ -861,7 +857,7 @@ function mergeCodexConfig(configPath, vectorBlock) {
         return;
     }
     const existing = fs_1.default.readFileSync(configPath, 'utf8');
-    const markerIndex = existing.indexOf(GSD_CODEX_MARKER);
+    const markerIndex = existing.indexOf(VECTOR_CODEX_MARKER);
     // Case 2: Has Vector marker — truncate and re-append
     if (markerIndex !== -1) {
         let before = existing.substring(0, markerIndex).trimEnd();
@@ -889,21 +885,21 @@ function mergeCodexConfig(configPath, vectorBlock) {
  * @param {string} vectorContent - Template content (without markers)
  */
 function mergeCopilotInstructions(filePath, vectorContent) {
-    const vectorBlock = GSD_COPILOT_INSTRUCTIONS_MARKER + '\n' +
+    const vectorBlock = VECTOR_COPILOT_INSTRUCTIONS_MARKER + '\n' +
         vectorContent.trim() + '\n' +
-        GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER;
+        VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER;
     // Case 1: No file — create fresh
     if (!fs_1.default.existsSync(filePath)) {
         fs_1.default.writeFileSync(filePath, vectorBlock + '\n');
         return;
     }
     const existing = fs_1.default.readFileSync(filePath, 'utf8');
-    const openIndex = existing.indexOf(GSD_COPILOT_INSTRUCTIONS_MARKER);
-    const closeIndex = existing.indexOf(GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER);
+    const openIndex = existing.indexOf(VECTOR_COPILOT_INSTRUCTIONS_MARKER);
+    const closeIndex = existing.indexOf(VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER);
     // Case 2: Has Vector markers — replace between markers
     if (openIndex !== -1 && closeIndex !== -1) {
         const before = existing.substring(0, openIndex).trimEnd();
-        const after = existing.substring(closeIndex + GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER.length).trimStart();
+        const after = existing.substring(closeIndex + VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER.length).trimStart();
         let newContent = '';
         if (before)
             newContent += before + '\n\n';
@@ -924,12 +920,12 @@ function mergeCopilotInstructions(filePath, vectorContent) {
  * @param {string} content - File content
  * @returns {string|null} - Cleaned content or null if empty
  */
-function stripGsdFromCopilotInstructions(content) {
-    const openIndex = content.indexOf(GSD_COPILOT_INSTRUCTIONS_MARKER);
-    const closeIndex = content.indexOf(GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER);
+function stripVectorFromCopilotInstructions(content) {
+    const openIndex = content.indexOf(VECTOR_COPILOT_INSTRUCTIONS_MARKER);
+    const closeIndex = content.indexOf(VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER);
     if (openIndex !== -1 && closeIndex !== -1) {
         const before = content.substring(0, openIndex).trimEnd();
-        const after = content.substring(closeIndex + GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER.length).trimStart();
+        const after = content.substring(closeIndex + VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER.length).trimStart();
         const cleaned = (before + (before && after ? '\n\n' : '') + after).trim();
         if (!cleaned)
             return null;
@@ -949,12 +945,12 @@ function installCodexConfig(targetDir, agentsSrc) {
     const agentEntries = fs_1.default.readdirSync(agentsSrc).filter(f => f.startsWith('vector-') && f.endsWith('.md'));
     const agents = [];
     // Compute the Codex Vector install path (absolute, so subagents with empty $HOME work — #820)
-    const codexGsdPath = `${path_1.default.resolve(targetDir, 'core').replace(/\\/g, '/')}/`;
+    const codexVectorPath = `${path_1.default.resolve(targetDir, 'core').replace(/\\/g, '/')}/`;
     for (const file of agentEntries) {
         let content = fs_1.default.readFileSync(path_1.default.join(agentsSrc, file), 'utf8');
         // Replace full .claude/core prefix so path resolves to codex Vector install
-        content = content.replace(/~\/\.claude\/core\//g, codexGsdPath);
-        content = content.replace(/\$HOME\/\.claude\/core\//g, codexGsdPath);
+        content = content.replace(/~\/\.claude\/core\//g, codexVectorPath);
+        content = content.replace(/\$HOME\/\.claude\/core\//g, codexVectorPath);
         const { frontmatter } = extractFrontmatterAndBody(content);
         const name = (frontmatter ? extractFrontmatterField(frontmatter, 'name') : null) || file.replace('.md', '');
         const description = (frontmatter ? extractFrontmatterField(frontmatter, 'description') : null) || '';
@@ -1662,7 +1658,7 @@ function uninstall(isGlobal, runtime = 'claude') {
         const configPath = path_1.default.join(targetDir, 'config.toml');
         if (fs_1.default.existsSync(configPath)) {
             const content = fs_1.default.readFileSync(configPath, 'utf8');
-            const cleaned = stripGsdFromCodexConfig(content);
+            const cleaned = stripVectorFromCodexConfig(content);
             if (cleaned === null) {
                 // File is empty after stripping — delete it
                 fs_1.default.unlinkSync(configPath);
@@ -1697,7 +1693,7 @@ function uninstall(isGlobal, runtime = 'claude') {
         const instructionsPath = path_1.default.join(targetDir, 'copilot-instructions.md');
         if (fs_1.default.existsSync(instructionsPath)) {
             const content = fs_1.default.readFileSync(instructionsPath, 'utf8');
-            const cleaned = stripGsdFromCopilotInstructions(content);
+            const cleaned = stripVectorFromCopilotInstructions(content);
             if (cleaned === null) {
                 fs_1.default.unlinkSync(instructionsPath);
                 removedCount++;
@@ -1813,8 +1809,8 @@ function uninstall(isGlobal, runtime = 'claude') {
                 const e = entry;
                 if (e.hooks && Array.isArray(e.hooks)) {
                     // Filter out Vector hooks
-                    const hasGsdHook = e.hooks.some((h) => h.command && (h.command.includes('vector-check-update') || h.command.includes('vector-statusline')));
-                    return !hasGsdHook;
+                    const hasVectorHook = e.hooks.some((h) => h.command && (h.command.includes('vector-check-update') || h.command.includes('vector-statusline')));
+                    return !hasVectorHook;
                 }
                 return true;
             });
@@ -1834,8 +1830,8 @@ function uninstall(isGlobal, runtime = 'claude') {
                 settingsHooks[eventName] = settingsHooks[eventName].filter(entry => {
                     const e = entry;
                     if (e.hooks && Array.isArray(e.hooks)) {
-                        const hasGsdHook = e.hooks.some((h) => h.command && h.command.includes('vector-context-monitor'));
-                        return !hasGsdHook;
+                        const hasVectorHook = e.hooks.some((h) => h.command && h.command.includes('vector-context-monitor'));
+                        return !hasVectorHook;
                     }
                     return true;
                 });
@@ -2582,11 +2578,11 @@ function install(isGlobal, runtime = 'claude') {
         if (!hooksMap.SessionStart) {
             hooksMap.SessionStart = [];
         }
-        const hasGsdUpdateHook = hooksMap.SessionStart.some((entry) => {
+        const hasVectorUpdateHook = hooksMap.SessionStart.some((entry) => {
             const e = entry;
             return e.hooks && Array.isArray(e.hooks) && e.hooks.some((h) => h.command && h.command.includes('vector-check-update'));
         });
-        if (!hasGsdUpdateHook) {
+        if (!hasVectorUpdateHook) {
             hooksMap.SessionStart.push({
                 hooks: [
                     {
@@ -2664,7 +2660,7 @@ function finishInstall(settingsPath, settings, statuslineCommand, shouldInstallS
     console.log(`
   ${green}Done!${reset} Open a blank directory in ${program} and run ${cyan}${command}${reset}.
 
-  ${cyan}Join the community:${reset} https://discord.gg/gsd
+  ${cyan}Join the community:${reset} https://discord.gg/rkU8UTu7dY
 `);
 }
 /**
@@ -2831,12 +2827,12 @@ if (process.env.VECTOR_TEST_MODE) {
         convertClaudeAgentToCodexAgent,
         generateCodexAgentToml,
         generateCodexConfigBlock,
-        stripGsdFromCodexConfig,
+        stripVectorFromCodexConfig,
         mergeCodexConfig,
         installCodexConfig,
         convertClaudeCommandToCodexSkill,
         convertClaudeToOpencodeFrontmatter,
-        GSD_CODEX_MARKER,
+        VECTOR_CODEX_MARKER,
         CODEX_AGENT_SANDBOX,
         getDirName,
         getGlobalDir,
@@ -2847,10 +2843,10 @@ if (process.env.VECTOR_TEST_MODE) {
         convertClaudeCommandToCopilotSkill,
         convertClaudeAgentToCopilotAgent,
         copyCommandsAsCopilotSkills,
-        GSD_COPILOT_INSTRUCTIONS_MARKER,
-        GSD_COPILOT_INSTRUCTIONS_CLOSE_MARKER,
+        VECTOR_COPILOT_INSTRUCTIONS_MARKER,
+        VECTOR_COPILOT_INSTRUCTIONS_CLOSE_MARKER,
         mergeCopilotInstructions,
-        stripGsdFromCopilotInstructions,
+        stripVectorFromCopilotInstructions,
         convertClaudeToAntigravityContent,
         convertClaudeCommandToAntigravitySkill,
         convertClaudeAgentToAntigravityAgent,