universal-dev-standards 6.1.1 → 6.2.0

package/src/utils/skills-source.js

@@ -0,0 +1,51 @@
+/**
+ * Skills source directory resolution — single source of truth.
+ *
+ * Two modules need to answer "where do the skill files live on this machine?", and they
+ * used to answer it separately. `github.js` had its own hardcoded copy pointing at
+ * `<cli>/../skills/claude-code`, a layout that no longer exists:
+ *
+ *   - in a checkout, skills live at `<repo>/skills/<name>/`, with no `claude-code/` level
+ *   - in an npm install, they are bundled at `<package>/bundled/skills/<name>/`
+ *
+ * So `hasLocalSkills()` was permanently false, every install silently fell through to the
+ * remote-download path, and that path then failed on files most skills do not have
+ * (only 5 of 61 ship a README.md), which failed the install transaction.
+ *
+ * Keeping the resolution in one module is the point: the bug was not the wrong path,
+ * it was the second copy of the path.
+ */
+
+import { existsSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/** CLI package root — `cli/` in a checkout, the package root in an npm install. */
+export const CLI_ROOT = join(__dirname, '..', '..');
+
+/** Bundled assets directory, present in npm installs. */
+export const BUNDLED_DIR = join(CLI_ROOT, 'bundled');
+
+/**
+ * Resolve the skills source directory.
+ * Prefers the bundled copy (npm install), falls back to the repo layout (development).
+ * @returns {string} Absolute path to the skills source directory
+ */
+export function getSkillsSourceDir() {
+  const bundledPath = join(BUNDLED_DIR, 'skills');
+  if (existsSync(bundledPath)) {
+    return bundledPath;
+  }
+  // Development environment fallback: <repo>/skills
+  return join(CLI_ROOT, '..', 'skills');
+}
+
+/**
+ * Whether skill files are available locally, making a remote download unnecessary.
+ * @returns {boolean}
+ */
+export function hasLocalSkillsSource() {
+  return existsSync(getSkillsSourceDir());
+}

package/src/utils/standard-fixer.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import yaml from 'js-yaml';
+import * as yaml from 'js-yaml';
 import { exec } from 'child_process';
 import util from 'util';
 import { pathToFileURL } from 'node:url';

package/src/utils/standard-validator.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import yaml from 'js-yaml';
+import * as yaml from 'js-yaml';
 import { exec } from 'child_process';
 import util from 'util';
 import { pathToFileURL } from 'node:url';

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "6.1.1",
+  "version": "6.2.0",
   "lastUpdated": "2026-05-13",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -58,18 +58,20 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "6.1.1"
+      "version": "6.2.0"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
-      "version": "6.1.1",
+      "version": "6.2.0",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
   "supportedAITools": {
+    "_note": "INFORMATIONAL MIRROR. No code reads this block -- the CLI's actual install behaviour is driven by cli/src/config/ai-agent-paths.js, and integrations/REGISTRY.json is the SSOT for tier and deprecation. Kept in sync by scripts/check-integration-liveness.ts so the three cannot drift apart silently again (they did, for 5.5 months, on antigravity.supportsSkills).",
+    "_noteZh": "資訊性鏡像。沒有任何程式讀取此區塊——CLI 實際的安裝行為由 cli/src/config/ai-agent-paths.js 驅動，tier 與停用狀態的 SSOT 是 integrations/REGISTRY.json。由 scripts/check-integration-liveness.ts 維持同步，避免三者再次無聲漂移（antigravity.supportsSkills 曾漂移 5.5 個月）。",
     "claude-code": {
       "name": "Claude Code",
       "skillsPath": "skills",
@@ -197,8 +199,8 @@
       "skillsPath": "skills",
       "nativePaths": {
         "skills": {
-          "project": ".codex/skills/",
-          "user": "~/.codex/skills/"
+          "project": ".agents/skills/",
+          "user": "~/.agents/skills/"
         },
         "agents": {
           "project": ".codex/agents/",
@@ -210,7 +212,8 @@
       "supportsCommands": false,
       "supportsTask": false,
       "supportsAgents": true,
-      "status": "partial"
+      "status": "partial",
+      "skillsPathNote": "Verified 2026-07-23 against developers.openai.com/codex/skills. Codex reads .agents/skills (plural). The previous '.codex/skills/' was a directory UDS invented and Codex never reads."
     },
     "copilot": {
       "name": "GitHub Copilot",
@@ -256,6 +259,10 @@
     },
     "gemini-cli": {
       "name": "Gemini CLI",
+      "deprecated": true,
+      "deprecationNote": "Google sunset Gemini CLI on 2026-06-18; succeeded by Antigravity CLI. The integrations/gemini-cli/ and .gemini/ trees are frozen -- see .gemini/DEPRECATED.md.",
+      "deprecationNoteZh": "Google 已於 2026-06-18 終止 Gemini CLI，由 Antigravity CLI 接手。integrations/gemini-cli/ 與 .gemini/ 兩棵樹已凍結——見 .gemini/DEPRECATED.md。",
+      "supersededBy": "antigravity",
       "skillsPath": "skills",
       "nativePaths": {
         "skills": {
@@ -284,12 +291,15 @@
     "antigravity": {
       "name": "Google Antigravity",
       "skillsPath": null,
+      "skillsPathStatus": "unverified",
+      "skillsPathNote": "Antigravity supports skills, but UDS has not verified where it reads them from. Candidates: '~/.gemini/antigravity-cli/plugins/<name>/skills/' (official plugin docs) and '.agent/skills/' (UDS's own 2026-02 spec, written in the Gemini CLI era). skillsPath stays null until one is confirmed against a real CLI -- an unverified path fails silently. Tracked as XSPEC-355 OQ6.",
+      "skillsPathNoteZh": "Antigravity 支援 skills，但 UDS 尚未驗證它實際從何處讀取。候選路徑：'~/.gemini/antigravity-cli/plugins/<name>/skills/'（官方 plugin 文件）與 '.agent/skills/'（UDS 自己 2026-02 的 spec，寫於 Gemini CLI 時代）。在對實際 CLI 確認之前 skillsPath 維持 null——路徑填錯會是靜默失敗。追蹤於 XSPEC-355 OQ6。",
       "nativePaths": {
         "config": {
           "project": "INSTRUCTIONS.md"
         }
       },
-      "supportsSkills": false,
+      "supportsSkills": true,
       "supportsCommands": false,
       "supportsTask": false,
       "supportsAgents": false,
@@ -2226,7 +2236,7 @@
       "id": "license-compliance",
       "name": "License Compliance Standards",
       "nameZh": "授權合規標準",
-      "version": "6.1.1",
+      "version": "6.2.0",
       "source": {
         "human": "core/license-compliance.md",
         "ai": "ai/standards/license-compliance.ai.yaml"
@@ -2238,7 +2248,7 @@
       "id": "verification-oracle",
       "name": "Verification Oracle Standards",
       "nameZh": "驗證 Oracle 標準",
-      "version": "6.1.1",
+      "version": "6.2.0",
       "source": {
         "human": "core/verification-oracle.md",
         "ai": "ai/standards/verification-oracle.ai.yaml"
@@ -2250,7 +2260,7 @@
       "id": "model-provenance",
       "name": "Model Provenance Policy Standards",
       "nameZh": "模型來源政策標準",
-      "version": "6.1.1",
+      "version": "6.2.0",
       "source": {
         "human": "core/model-provenance.md",
         "ai": "ai/standards/model-provenance.ai.yaml"
@@ -2262,7 +2272,7 @@
       "id": "resource-cost-boundary",
       "name": "Resource / Cost Boundary Declaration Standards",
       "nameZh": "資源／成本邊界宣告標準",
-      "version": "6.1.1",
+      "version": "6.2.0",
       "source": {
         "human": "core/resource-cost-boundary.md",
         "ai": "ai/standards/resource-cost-boundary.ai.yaml"