universal-dev-standards 6.7.5 → 6.9.0

package/src/utils/yaml-generator.js

@@ -4,8 +4,44 @@
  * Generates AI-optimized YAML from parsed Markdown structure.
  */
 
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
 import { SECTION_MAPPINGS, STANDARD_ID_MAPPING } from './conversion-rules.js';
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// cli/src/utils/yaml-generator.js -> cli/src/utils -> cli/src -> cli -> repo root
+const REPO_ROOT = resolve(__dirname, '../../..');
+
+/**
+ * XSPEC-392 R2: `meta.updated` must reflect when the source file's content
+ * actually last changed, not a hand-typed `**Last Updated**` line (which can
+ * go stale relative to the file it lives in), and — this is the part that is
+ * not negotiable — never a `new Date()` value standing in for "the day this
+ * script happened to run".
+ *
+ * Returns an ISO date (YYYY-MM-DD) from git history for `relativeSourcePath`,
+ * or `null` when git has no record for it (untracked/new file, git missing,
+ * or any other failure). A missing `updated` field is honest; a fabricated
+ * one is not — so callers must omit the field entirely rather than fall back
+ * to any other date source.
+ */
+function getGitLastModifiedDate(relativeSourcePath) {
+  if (!relativeSourcePath) return null;
+  try {
+    const out = execFileSync(
+      'git',
+      ['log', '-1', '--format=%ad', '--date=short', '--', relativeSourcePath],
+      { cwd: REPO_ROOT, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }
+    ).trim();
+    return out || null;
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Generate AI-YAML structure from parsed Markdown
  * @param {Object} parsed - Parsed Markdown structure from md-parser
@@ -18,16 +54,22 @@ export function generateAiYaml(parsed, options = {}) {
   // Generate ID
   const id = generateStandardId(filename, parsed.metadata.title);
 
-  // Build YAML structure
-  const yaml = {
-    id,
-    meta: {
-      version: parsed.metadata.version || '1.0.0',
-      updated: parsed.metadata.updated || new Date().toISOString().split('T')[0],
-      source: inferSourcePath(filename, locale),
-      description: parsed.purpose || parsed.metadata.title || ''
-    }
+  const sourcePath = inferSourcePath(filename, locale);
+
+  // Build YAML structure. `updated` is set from git history below, and is
+  // deliberately absent (not null) when git has no record for the file —
+  // see getGitLastModifiedDate.
+  const meta = {
+    version: parsed.metadata.version || '1.0.0'
   };
+  const gitUpdated = getGitLastModifiedDate(sourcePath);
+  if (gitUpdated) {
+    meta.updated = gitUpdated;
+  }
+  meta.source = sourcePath;
+  meta.description = parsed.purpose || parsed.metadata.title || '';
+
+  const yaml = { id, meta };
 
   // Add language if locale specified
   if (locale) {

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "6.7.5",
+  "version": "6.9.0",
   "lastUpdated": "2026-05-13",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -58,14 +58,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "6.7.5"
+      "version": "6.9.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.7.5",
+      "version": "6.9.0",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
@@ -736,6 +736,17 @@
       "category": "core",
       "description": "Four behavioral disciplines for AI agents: Ask (surface assumptions), Simple (minimum code), Precision (scope only what's needed), Test (loop until verified)"
     },
+    {
+      "id": "turn-completion-integrity",
+      "name": "Turn Completion Integrity",
+      "nameZh": "回合收尾完整性標準",
+      "source": {
+        "human": "core/turn-completion-integrity.md",
+        "ai": "ai/standards/turn-completion-integrity.ai.yaml"
+      },
+      "category": "core",
+      "description": "An agent must not end a turn having stated a next action it did not take; enforced at turn end by a Stop hook, with a per-language corpus that runs in CI"
+    },
     {
       "id": "ai-friendly-architecture",
       "name": "AI-Friendly Architecture",
@@ -1569,7 +1580,7 @@
       "id": "antigravity-integration",
       "name": "Google Antigravity Instructions",
       "nameZh": "Google Antigravity 指令",
-      "source": "integrations/google-antigravity/INSTRUCTIONS.md",
+      "source": "integrations/google-antigravity/AGENTS.md",
       "category": "integration",
       "skillName": null,
       "description": "System prompt snippets for Google Antigravity agent",
@@ -1766,6 +1777,18 @@
       "skillName": null,
       "description": "Aim a fix at the set, not the member. Walk the set from the source the system reads, never from a typed list; print the denominator and what was excluded; prove the check non-vacuous per sub-set"
     },
+    {
+      "id": "deferred-item-exit",
+      "name": "Deferred Item Exit Standard",
+      "nameZh": "延後項目出口標準",
+      "source": {
+        "human": "core/deferred-item-exit.md",
+        "ai": "ai/standards/deferred-item-exit.ai.yaml"
+      },
+      "category": "reference",
+      "skillName": null,
+      "description": "A deferred item must leave the document: a traceable exit outside it, identified beside the item. The carrier is deliberately unspecified. A present link is not a working link — verified and unverified links are two states, never one green. Anchor on document structure, not wording"
+    },
     {
       "id": "verification-evidence",
       "name": "Verification Evidence Standard",
@@ -2260,7 +2283,7 @@
       "id": "license-compliance",
       "name": "License Compliance Standards",
       "nameZh": "授權合規標準",
-      "version": "6.7.5",
+      "version": "6.9.0",
       "source": {
         "human": "core/license-compliance.md",
         "ai": "ai/standards/license-compliance.ai.yaml"
@@ -2272,7 +2295,7 @@
       "id": "verification-oracle",
       "name": "Verification Oracle Standards",
       "nameZh": "驗證 Oracle 標準",
-      "version": "6.7.5",
+      "version": "6.9.0",
       "source": {
         "human": "core/verification-oracle.md",
         "ai": "ai/standards/verification-oracle.ai.yaml"
@@ -2284,7 +2307,7 @@
       "id": "model-provenance",
       "name": "Model Provenance Policy Standards",
       "nameZh": "模型來源政策標準",
-      "version": "6.7.5",
+      "version": "6.9.0",
       "source": {
         "human": "core/model-provenance.md",
         "ai": "ai/standards/model-provenance.ai.yaml"
@@ -2296,7 +2319,7 @@
       "id": "resource-cost-boundary",
       "name": "Resource / Cost Boundary Declaration Standards",
       "nameZh": "資源／成本邊界宣告標準",
-      "version": "6.7.5",
+      "version": "6.9.0",
       "source": {
         "human": "core/resource-cost-boundary.md",
         "ai": "ai/standards/resource-cost-boundary.ai.yaml"

package/src/commands/sync.js

@@ -1,133 +0,0 @@
-/**
- * Sync Command — Export current work context for session resume
- * Zero AI tokens — pure shell/JS execution
- *
- * @module commands/sync
- * @see specs/superspec-borrowing-phase1-2-spec.md (AC-16, AC-17)
- */
-
-import { execSync } from 'child_process';
-import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from 'fs';
-import { join } from 'path';
-
-const MAX_LINES = 500;
-
-/**
- * Generate context.md from git info and optional workflow state
- * @param {string} projectPath - Project root directory
- * @returns {string} Path to generated context.md
- */
-export function generateContext(projectPath) {
-  const lines = [];
-
-  lines.push('# Development Context');
-  lines.push(`> Auto-generated by \`uds sync\` at ${new Date().toISOString()}`);
-  lines.push('> This file helps restore context in a new AI session.');
-  lines.push('');
-
-  // ─── Git Status ───
-  lines.push('## Git Status');
-  lines.push('');
-
-  const branch = gitCmd('git rev-parse --abbrev-ref HEAD', projectPath);
-  lines.push(`- **Branch**: ${branch}`);
-
-  const baseBranch = detectBaseBranch(projectPath);
-  if (baseBranch && baseBranch !== branch) {
-    const commitCount = gitCmd(`git rev-list --count ${baseBranch}..HEAD`, projectPath) || '0';
-    lines.push(`- **Base**: ${baseBranch} (+${commitCount} commits)`);
-  }
-
-  lines.push('');
-  lines.push('### Recent Commits');
-  lines.push('');
-
-  const logOutput = gitCmd('git log --oneline -20', projectPath);
-  if (logOutput) {
-    lines.push(...logOutput.split('\n').map(l => `- ${l}`));
-  } else {
-    lines.push('(no commits)');
-  }
-  lines.push('');
-
-  lines.push('### Changed Files');
-  lines.push('');
-
-  if (baseBranch && baseBranch !== branch) {
-    const diffStat = gitCmd(`git diff --stat ${baseBranch}..HEAD`, projectPath);
-    if (diffStat) {
-      lines.push('```');
-      lines.push(...diffStat.split('\n'));
-      lines.push('```');
-    }
-  } else {
-    lines.push('(on base branch, no diff)');
-  }
-  lines.push('');
-
-  // ─── Workflow State ───
-  const workflowState = readWorkflowState(projectPath);
-  if (workflowState) {
-    lines.push('## Workflow State');
-    lines.push('');
-    lines.push(...workflowState);
-    lines.push('');
-  }
-
-  // Truncate to MAX_LINES
-  const truncated = lines.slice(0, MAX_LINES);
-
-  // Write to .workflow-state/context.md
-  const outputDir = join(projectPath, '.workflow-state');
-  mkdirSync(outputDir, { recursive: true });
-  const outputPath = join(outputDir, 'context.md');
-  writeFileSync(outputPath, truncated.join('\n'), 'utf-8');
-
-  return outputPath;
-}
-
-// ─── Helpers ───
-
-function gitCmd(cmd, cwd) {
-  try {
-    return execSync(cmd, { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
-  } catch {
-    return '';
-  }
-}
-
-function detectBaseBranch(projectPath) {
-  // Check for common base branches
-  for (const name of ['main', 'master']) {
-    const exists = gitCmd(`git rev-parse --verify ${name}`, projectPath);
-    if (exists) return name;
-  }
-  return null;
-}
-
-function readWorkflowState(projectPath) {
-  const stateDir = join(projectPath, '.workflow-state');
-  if (!existsSync(stateDir)) return null;
-
-  const yamlFiles = readdirSync(stateDir)
-    .filter(f => f.endsWith('.yaml') && !f.endsWith('.log.yaml'))
-    .sort();
-
-  if (yamlFiles.length === 0) return null;
-
-  // Read the most recent state file
-  const latestFile = yamlFiles[yamlFiles.length - 1];
-  const content = readFileSync(join(stateDir, latestFile), 'utf-8');
-
-  const lines = [];
-  // Extract key fields
-  const specMatch = content.match(/spec_id:\s*(.+)/);
-  const phaseMatch = content.match(/current_phase:\s*(.+)/);
-  const statusMatch = content.match(/status:\s*(.+)/);
-
-  if (specMatch) lines.push(`- **Spec**: ${specMatch[1].trim()}`);
-  if (phaseMatch) lines.push(`- **Phase**: ${phaseMatch[1].trim()}`);
-  if (statusMatch) lines.push(`- **Status**: ${statusMatch[1].trim()}`);
-
-  return lines.length > 0 ? lines : null;
-}