@valentia-ai-skills/framework 2.0.1 → 2.0.3

package/bin/cli.js

@@ -1217,7 +1217,6 @@ async function cmdAnalyze() {
   console.log(`Analyzing ${c("bold", filesChanged.length)} file(s) against ${c("bold", skillNames.length)} skill(s)...`);
   console.log(c("dim", `Commit: ${commitHash?.slice(0, 8)} — ${commitMessage}`));
   console.log(c("dim", `Branch: ${branch}\n`));
-
   let projectName = null;
   try {
     const pkgPath = path.join(PROJECT_ROOT, "package.json");
@@ -1279,6 +1278,299 @@ async function cmdAnalyze() {
   }
 }
 
+// ── Upload Legacy Scan Command ──
+
+const UPLOAD_LEGACY_SCAN_URL =
+  process.env.AI_SKILLS_UPLOAD_LEGACY_URL ||
+  "https://znshdhjquohrzvbnloki.supabase.co/functions/v1/upload-legacy-scan";
+
+function fetchJSONWithAuth(url, body, token) {
+  return new Promise((resolve, reject) => {
+    const parsed = new URL(url);
+    const mod = parsed.protocol === "https:" ? https : http;
+    const postData = JSON.stringify(body);
+
+    const headers = {
+      "Content-Type": "application/json",
+      "Content-Length": Buffer.byteLength(postData),
+    };
+    if (token) headers["Authorization"] = `Bearer ${token}`;
+
+    const req = mod.request(
+      { hostname: parsed.hostname, port: parsed.port, path: parsed.pathname + parsed.search, method: "POST", headers },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => {
+          try {
+            const json = JSON.parse(data);
+            if (res.statusCode >= 400) {
+              reject(new Error(json.error || `HTTP ${res.statusCode}`));
+            } else {
+              resolve(json);
+            }
+          } catch {
+            reject(new Error(`Invalid response: ${data.slice(0, 200)}`));
+          }
+        });
+      }
+    );
+    req.on("error", reject);
+    req.write(postData);
+    req.end();
+  });
+}
+
+async function cmdUploadLegacyScan() {
+  console.log(c("blue", "\n━━━ AI Skills Framework — Upload Legacy Scan ━━━\n"));
+
+  const args = process.argv.slice(3);
+  let scanPath = null;
+  let authToken = null;
+  let dryRun = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--path" && args[i + 1]) { scanPath = args[++i]; }
+    else if (args[i] === "--token" && args[i + 1]) { authToken = args[++i]; }
+    else if (args[i] === "--dry-run") { dryRun = true; }
+  }
+
+  if (!scanPath) {
+    console.log(c("red", "✗ --path is required."));
+    console.log(c("dim", "  Usage: npx ai-skills upload-legacy-scan --path ./my-project-intelligence/\n"));
+    process.exit(1);
+  }
+
+  const resolvedPath = path.resolve(scanPath);
+  if (!fs.existsSync(resolvedPath)) {
+    console.log(c("red", `✗ Path not found: ${resolvedPath}`));
+    process.exit(1);
+  }
+
+  // ── Read and validate manifest.json ──
+  const manifestPath = path.join(resolvedPath, "manifest.json");
+  if (!fs.existsSync(manifestPath)) {
+    console.log(c("red", `✗ manifest.json not found in ${resolvedPath}`));
+    console.log(c("dim", "  The intelligence folder must contain a manifest.json file.\n"));
+    process.exit(1);
+  }
+
+  let manifest;
+  try {
+    manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+  } catch (err) {
+    console.log(c("red", `✗ Failed to parse manifest.json: ${err.message}`));
+    process.exit(1);
+  }
+
+  const missing = ["project", "scanned_at", "skills", "statistics"].filter((k) => !manifest[k]);
+  if (missing.length > 0) {
+    console.log(c("red", `✗ manifest.json missing required fields: ${missing.join(", ")}`));
+    process.exit(1);
+  }
+
+  // ── Normalize manifest fields (handles alternate scanner output formats) ──
+  if (!manifest.statistics) manifest.statistics = {};
+  const mstats = manifest.statistics;
+  // Some scanners output completionPercentage instead of completeness_score
+  if (mstats.completeness_score === undefined) {
+    mstats.completeness_score = mstats.completionPercentage ?? 0;
+  }
+  // Some scanners put module count in source.modules
+  if (mstats.total_modules === undefined) {
+    mstats.total_modules =
+      manifest.source?.modules ??
+      manifest.source?.fileCount ??
+      (manifest.skills?.length ?? 0);
+  }
+  // Build tech_stack from source fields or scalar values in technologies if missing
+  if (!manifest.tech_stack) {
+    if (manifest.source) {
+      const ts = {};
+      if (manifest.source.language) ts.language = manifest.source.language;
+      if (manifest.source.framework) ts.framework = manifest.source.framework;
+      manifest.tech_stack = ts;
+    } else if (manifest.technologies && typeof manifest.technologies === "object" && !Array.isArray(manifest.technologies)) {
+      // Only use scalar leaf values to avoid [object Object] in display
+      const ts = {};
+      for (const [k, v] of Object.entries(manifest.technologies)) {
+        if (typeof v === "string" || typeof v === "number") ts[k] = v;
+      }
+      manifest.tech_stack = ts;
+    } else {
+      manifest.tech_stack = {};
+    }
+  }
+
+  const projectName = manifest.project;
+  console.log(`Project: ${c("bold", projectName)}`);
+  console.log(`Scanned: ${c("dim", manifest.scanned_at)}`);
+  if (manifest.tech_stack) {
+    const stackParts = Object.entries(manifest.tech_stack)
+      .filter(([, v]) => v)
+      .map(([k, v]) => `${k}: ${v}`)
+      .join(", ");
+    if (stackParts) console.log(`Stack: ${c("cyan", stackParts)}`);
+  }
+
+  // ── Read skill files ──
+  const skillPayload = [];
+  for (const skillEntry of (manifest.skills || [])) {
+    const skillFile = skillEntry.file || skillEntry.path; // accept both field names
+    if (!skillEntry.name || !skillFile) continue;
+    const skillFilePath = path.join(resolvedPath, skillFile);
+    if (!fs.existsSync(skillFilePath)) {
+      console.log(c("yellow", `  ⚠ Skill file not found: ${skillFile} — skipping`));
+      continue;
+    }
+    skillPayload.push({
+      name: skillEntry.name,
+      type: skillEntry.type || "module",
+      content: fs.readFileSync(skillFilePath, "utf-8"),
+    });
+  }
+  console.log(`Skills: ${c("green", skillPayload.length.toString())} module(s)`);
+
+  // ── Read diagram files ──
+  const diagramPayload = [];
+  for (const diagramEntry of (manifest.diagrams || [])) {
+    const diagramFile = diagramEntry.file || diagramEntry.path; // accept both field names
+    if (!diagramEntry.name || !diagramFile) continue;
+    const diagramFilePath = path.join(resolvedPath, diagramFile);
+    if (!fs.existsSync(diagramFilePath)) {
+      console.log(c("yellow", `  ⚠ Diagram file not found: ${diagramFile} — skipping`));
+      continue;
+    }
+    diagramPayload.push({
+      name: diagramEntry.name,
+      type: diagramEntry.type || "architecture",
+      content: fs.readFileSync(diagramFilePath, "utf-8"),
+    });
+  }
+  // Auto-discover .mmd/.mermaid files from diagrams/ subdirectory if manifest listed none
+  if (diagramPayload.length === 0) {
+    const diagramsDir = path.join(resolvedPath, "diagrams");
+    if (fs.existsSync(diagramsDir)) {
+      for (const file of fs.readdirSync(diagramsDir).sort()) {
+        if (/\.(mmd|mermaid)$/i.test(file)) {
+          const name = file.replace(/\.(mmd|mermaid)$/i, "");
+          diagramPayload.push({
+            name,
+            type: "architecture",
+            content: fs.readFileSync(path.join(diagramsDir, file), "utf-8"),
+          });
+        }
+      }
+      if (diagramPayload.length > 0) {
+        console.log(c("dim", `  (auto-discovered ${diagramPayload.length} diagram(s) from diagrams/)`))
+      }
+    }
+  }
+  console.log(`Diagrams: ${c("green", diagramPayload.length.toString())} file(s)`);
+
+  // ── Read report files ──
+  const reportsPayload = {};
+  const reportFileMap = {
+    overview: ["OVERVIEW.md", "overview.md"],
+    api_registry: ["API_REGISTRY.md", "api_registry.md"],
+    business_rules: ["BUSINESS_RULES.md", "business_rules.md"],
+    data_models: ["DATA_MODELS.md", "data_models.md"],
+    dependencies: ["DEPENDENCIES.md", "dependencies.md"],
+    env_config: ["ENV_CONFIG.md", "env_config.md"],
+    risk_report: ["RISK_REPORT.md", "risk_report.md"],
+    glossary: ["GLOSSARY.md", "glossary.md"],
+    reproduction_guide: ["REPRODUCTION_GUIDE.md", "reproduction_guide.md"],
+  };
+
+  for (const [key, candidates] of Object.entries(reportFileMap)) {
+    for (const candidate of candidates) {
+      const reportPaths = [
+        path.join(resolvedPath, candidate),
+        path.join(resolvedPath, "reports", candidate),
+      ];
+      const found = reportPaths.find((p) => fs.existsSync(p));
+      if (found) {
+        reportsPayload[key] = fs.readFileSync(found, "utf-8");
+        break;
+      }
+    }
+  }
+
+  const reportCount = Object.keys(reportsPayload).length;
+  console.log(`Reports: ${c("green", reportCount.toString())} file(s)\n`);
+
+  // ── Dry run: print summary and exit ──
+  if (dryRun) {
+    console.log(c("yellow", "Dry run — payload summary:"));
+    const stats = manifest.statistics || {};
+    console.log(`  Project name: ${projectName}`);
+    console.log(`  Modules: ${skillPayload.length}`);
+    console.log(`  Diagrams: ${diagramPayload.length}`);
+    console.log(`  Reports: ${reportCount}`);
+    if (stats.completeness_score !== undefined) {
+      console.log(`  Completeness: ${stats.completeness_score}%`);
+    }
+    console.log(c("dim", "\nNo data was uploaded. Remove --dry-run to upload.\n"));
+    return;
+  }
+
+  // ── Resolve auth ──
+  let email = null;
+  if (!authToken) {
+    const config = loadConfig();
+    if (config?.email) {
+      email = config.email;
+      console.log(c("dim", `Using saved email: ${email}`));
+    } else {
+      console.log(c("yellow", "No saved config found. Enter your email to authenticate."));
+      email = await ask(`${c("bold", "Work email:")} `);
+      const otpResult = await requestOtpForEmail(email);
+      email = otpResult.email;
+      await verifyOtp(email); // we only need the OTP verification, not the toolkit
+    }
+  }
+
+  // ── Upload ──
+  console.log(c("dim", `Uploading to Valentia (${projectName})...\n`));
+  process.stdout.write(`  ${c("dim", "→")} Sending ${skillPayload.length} skills, ${diagramPayload.length} diagrams, ${reportCount} reports...`);
+
+  let result;
+  try {
+    result = await fetchJSONWithAuth(
+      UPLOAD_LEGACY_SCAN_URL,
+      {
+        project_name: projectName,
+        manifest,
+        skills: skillPayload,
+        diagrams: diagramPayload,
+        reports: reportsPayload,
+        email,
+      },
+      authToken
+    );
+    console.log(c("green", " done!\n"));
+  } catch (err) {
+    console.log(c("red", " failed!"));
+    console.log(c("red", `\n✗ Upload failed: ${err.message}`));
+    console.log(c("dim", "  Retry with --dry-run to validate your payload without uploading.\n"));
+    process.exit(1);
+  }
+
+  console.log(c("green", "✓ Upload complete!\n"));
+  console.log(`  Project ID: ${c("bold", result.project_id)}`);
+  console.log(`  Skills created: ${c("bold", (result.skills_created || []).length.toString())}`);
+  if (result.storage_urls?.diagrams?.length) {
+    console.log(`  Diagrams stored: ${c("dim", result.storage_urls.diagrams.length.toString())}`);
+  }
+  if (result.storage_urls?.reports?.length) {
+    console.log(`  Reports stored: ${c("dim", result.storage_urls.reports.length.toString())}`);
+  }
+  if (result.console_url) {
+    console.log(`\n  View in console: ${c("bold", result.console_url)}`);
+  }
+  console.log("");
+}
+
 // ── Main ──
 
 const command = process.argv[2] || "setup";
@@ -1290,6 +1582,7 @@ switch (command) {
   case "list": cmdList(); break;
   case "doctor": cmdDoctor(); break;
   case "analyze": cmdAnalyze(); break;
+  case "upload-legacy-scan": cmdUploadLegacyScan(); break;
   case "help": case "--help": case "-h":
     console.log(`
 ${c("blue", "AI Skills Framework")} — @valentia-ai-skills/framework
@@ -1300,10 +1593,14 @@ Usage:
   npx ai-skills status   Show installed toolkit, team, and tools
   npx ai-skills list     List locally bundled skills
   npx ai-skills analyze  Analyze last commit against active skills
+  npx ai-skills upload-legacy-scan  Upload a legacy codebase intelligence package
   npx ai-skills doctor   Health check (config + API + tools)
 
 Flags:
   analyze --last         Analyze the most recent commit
+  upload-legacy-scan --path <dir>   Path to intelligence folder
+  upload-legacy-scan --dry-run      Validate payload without uploading
+  upload-legacy-scan --token <tok>  Explicit auth token
 
 Toolkit includes: skills, agents, commands, hooks, rules, MCP configs.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentia-ai-skills/framework",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "AI development skills framework centralized coding standards, security patterns, and SOPs for AI-assisted development. Works with Claude Code, Cursor, Copilot, Windsurf, and any AI coding tool.",
   "keywords": [
     "ai-skills",

package/skills/global/aisupportapp-project-architecture/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/project-architecture
 description: Auto-generated project-architecture for aisupportapp. Created by project-scanner.
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 ---

package/skills/global/aisupportapp-project-conventions/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/project-conventions
 description: Auto-generated project-conventions for aisupportapp. Created by project-scanner.
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 ---

package/skills/global/aisupportapp-project-workflows/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/project-workflows
 description: Auto-generated project-workflows for aisupportapp. Created by project-scanner.
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 ---

package/skills/global/aisupportapp-test-installation/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/test-installation
 description: No description
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 # Skill Name

package/skills/global/api-design/SKILL.md

@@ -3,7 +3,7 @@ name: api-design
 description: No description
 version: 1.0.0
 scope: global
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 ---

package/skills/global/appointment-oas-app/SKILL.md

@@ -3,7 +3,7 @@ name: appointment-oas-app
 description: No description
 version: 1.0.1
 scope: global
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 ---

package/skills/global/code-standards/SKILL.md

@@ -3,7 +3,7 @@ name: code-standards
 description: No description
 version: 1.0.0
 scope: global
-last_reviewed: 2026-03-27
+last_reviewed: 2026-03-28
 ---
 
 ---