universal-dev-standards 5.0.0-beta.9 → 5.0.0-rc.10

package/bin/uds.js

@@ -16,9 +16,12 @@ import { agentListCommand, agentInstallCommand, agentInfoCommand } from '../src/
 import { workflowListCommand, workflowInstallCommand, workflowInfoCommand, workflowExecuteCommand, workflowStatusCommand } from '../src/commands/workflow.js';
 import { aiContextInitCommand, aiContextValidateCommand, aiContextGraphCommand } from '../src/commands/ai-context.js';
 import { sweepCommand } from '../src/commands/sweep.js';
+import { auditCommand } from '../src/commands/audit.js';
+import { uninstallCommand } from '../src/commands/uninstall.js';
 import { specCreateCommand, specListCommand, specShowCommand, specConfirmCommand, specArchiveCommand, specDeleteCommand } from '../src/commands/spec.js';
 import { startCommand, missionStatusCommand, missionPauseCommand, missionResumeCommand, missionCancelCommand, missionListCommand } from '../src/commands/start.js';
-import { setLanguage, setLanguageExplicit, detectLanguage } from '../src/i18n/messages.js';
+import { setLanguage, setLanguageExplicit, detectLanguage, t } from '../src/i18n/messages.js';
+import { maybeCheckForUpdates, formatUpdateNotice } from '../src/utils/update-checker.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -38,12 +41,24 @@ program
       // Explicit setting: mark as explicitly set to prevent override
       setLanguageExplicit(uiLang);
     }
+  })
+  .hook('postAction', async (thisCommand) => {
+    const cmd = thisCommand.name();
+    const notifyCommands = ['init', 'list', 'add', 'config'];
+    if (!notifyCommands.includes(cmd)) return;
+    try {
+      const result = await maybeCheckForUpdates(pkg.version);
+      if (result?.shouldNotify) {
+        console.log(formatUpdateNotice(result, t()));
+      }
+    } catch {
+      // Silent failure — update check should never break CLI
+    }
   });
 
 program
   .command('list')
   .description('List available standards')
-  .option('-l, --level <level>', 'Filter by adoption level (1, 2, or 3)')
   .option('-c, --category <category>', 'Filter by category (skill, reference, extension, integration, template)')
   .action(listCommand);
 
@@ -51,7 +66,6 @@ program
   .command('init')
   .description('Initialize standards in current project')
   .option('-m, --mode <mode>', 'Installation mode (skills, full)')
-  .option('-l, --level <level>', 'Adoption level (1=Essential, 2=Recommended, 3=Enterprise)')
   .option('-f, --format <format>', 'Standards format (ai, human, both)')
   .option('--workflow <workflow>', 'Git workflow (github-flow, gitflow, trunk-based)')
   .option('--merge-strategy <strategy>', 'Merge strategy (squash, merge-commit, rebase-ff)')
@@ -106,6 +120,7 @@ program
   .option('--restore', 'Restore all modified and missing files')
   .option('--restore-missing', 'Restore only missing files')
   .option('--no-interactive', 'Disable interactive mode')
+  .option('--ci', 'CI mode: disable interactive prompts and set exit code on issues')
   .option('--migrate', 'Migrate legacy manifest to hash-based tracking')
   .option('--offline', 'Skip npm registry check for CLI updates')
   .action(checkCommand);
@@ -137,6 +152,9 @@ program
   .option('--skills', 'Install/update Skills for configured AI tools')
   .option('--commands', 'Install/update slash commands for configured AI tools')
   .option('--debug', 'Show debug output for Skills/Commands detection')
+  .option('--plan', 'Show reconciliation plan without executing (like terraform plan)')
+  .option('--force', 'Force update all files, ignoring hash comparison')
+  .option('--rollback', 'Rollback to the most recent backup')
   .action(updateCommand);
 
 program
@@ -152,6 +170,30 @@ program
   .option('-v, --verbose', 'Show detailed output')
   .action(sweepCommand);
 
+program
+  .command('audit')
+  .description('Audit UDS installation and collect feedback')
+  .option('--health', 'Health check only')
+  .option('--patterns', 'Pattern detection only')
+  .option('--friction', 'Friction detection only')
+  .option('--report', 'Interactive feedback submission')
+  .option('--dry-run', 'Preview report without submitting')
+  .option('--gh', 'Force gh CLI for submission')
+  .option('--format <format>', 'Output format (json)')
+  .option('--quiet', 'Summary only')
+  .action(auditCommand);
+
+program
+  .command('uninstall')
+  .description('Remove UDS standards, integrations, skills, and hooks')
+  .option('--all', 'Remove everything including user-level installations')
+  .option('--standards-only', 'Remove only .standards/ directory')
+  .option('--skills-only', 'Remove only skills and commands')
+  .option('--integrations-only', 'Remove only UDS blocks from integration files')
+  .option('--dry-run', 'Preview mode, no files modified')
+  .option('-y, --yes', 'Skip confirmation prompts')
+  .action(uninstallCommand);
+
 // Spec command with subcommands (Vibe Coding)
 const specCommand = program
   .command('spec')

package/bundled/ai/FORMAT-GUIDE.md

@@ -0,0 +1,191 @@
+# AI Standards Format Guide
+
+This document explains the file format conventions used in the AI-optimized standards.
+
+## File Format Overview
+
+### English Standards (ai/)
+
+All English AI standards use **YAML format** with `.ai.yaml` extension:
+
+```
+ai/
+├── standards/
+│   ├── testing.ai.yaml
+│   ├── commit-message.ai.yaml
+│   └── ...
+└── options/
+    ├── testing/
+    │   ├── unit-testing.ai.yaml
+    │   └── ...
+    └── ...
+```
+
+### Localized Standards (locales/)
+
+Localized versions follow the same YAML format:
+
+```
+locales/
+├── zh-TW/
+│   └── ai/
+│       ├── standards/
+│       │   └── testing.ai.yaml
+│       └── options/
+│           └── testing/
+│               └── unit-testing.ai.yaml
+└── zh-CN/
+    └── ai/
+        └── ...
+```
+
+## Format Specification
+
+### Standard File Structure
+
+```yaml
+# <Standard Name> - AI Optimized
+# Source: core/<standard>.md
+
+id: <standard-id>
+meta:
+  version: "X.Y.Z"
+  updated: "YYYY-MM-DD"
+  source: core/<standard>.md
+  description: <brief description>
+
+# Main content sections
+<section>:
+  <subsection>:
+    <key>: <value>
+
+# Rules for AI behavior
+rules:
+  - id: <rule-id>
+    trigger: <when to apply>
+    instruction: <what to do>
+    priority: required|recommended
+
+# Quick reference tables
+quick_reference:
+  <table_name>:
+    columns: [Col1, Col2, Col3]
+    rows:
+      - [val1, val2, val3]
+```
+
+### Option File Structure
+
+```yaml
+# <Option Name> - AI Optimized Option
+# Parent: <parent-standard>
+
+id: <option-id>
+meta:
+  parent: <parent-standard-id>
+  version: "X.Y.Z"
+  description: <brief description>
+
+best_for:
+  - <use case 1>
+  - <use case 2>
+
+# Option-specific content
+<section>:
+  <content>
+
+rules:
+  - id: <rule-id>
+    trigger: <when to apply>
+    instruction: <what to do>
+    priority: required|recommended
+```
+
+## Design Rationale
+
+### Why YAML?
+
+1. **AI-Friendly**: Structured data is easier for AI to parse and apply
+2. **Human-Readable**: Clear hierarchy without syntax noise
+3. **Tool Support**: Wide ecosystem support for validation and processing
+4. **Extensible**: Easy to add new fields without breaking existing parsers
+
+### Why `.ai.yaml` Extension?
+
+1. **Identification**: Clearly marks files as AI-optimized standards
+2. **Differentiation**: Distinguishes from regular YAML config files
+3. **Tooling**: Enables specialized linting/validation rules
+4. **Search**: Easy to find all AI standards with glob patterns
+
+### Why Separate from Core Standards?
+
+1. **Dual Purpose**: Core standards (Markdown) for humans, AI standards (YAML) for AI
+2. **Optimization**: AI standards can be structured for efficient token usage
+3. **Flexibility**: AI standards can include trigger rules and quick references
+4. **Maintenance**: Can update AI format independently of human-readable docs
+
+## Localization Guidelines
+
+### Field Translation
+
+| Field | Translate? | Notes |
+|-------|------------|-------|
+| id | No | Keep as identifier |
+| version | No | Same as source |
+| description | Yes | Localize |
+| rules.instruction | Yes | Localize |
+| quick_reference columns | Yes | Localize headers |
+| quick_reference rows | Yes | Localize content |
+
+### Metadata Header
+
+Localized files include translation metadata:
+
+```yaml
+# Note: This is included in the file header comment
+# source_version: <version of source file>
+# translation_version: <version of translation>
+# last_synced: <date>
+```
+
+## Validation
+
+### Required Fields
+
+Every standard file must have:
+- `id`
+- `meta.version`
+- `meta.description`
+
+### Optional but Recommended
+
+- `rules[]` - AI behavior triggers
+- `quick_reference` - Summary tables
+- `options` - Sub-options (for parent standards)
+
+## Examples
+
+### Minimal Standard
+
+```yaml
+id: example
+meta:
+  version: "1.0.0"
+  description: Example standard
+
+rules:
+  - id: basic-rule
+    trigger: always
+    instruction: Follow this guideline
+    priority: required
+```
+
+### Full Standard
+
+See [testing.ai.yaml](standards/testing.ai.yaml) for a complete example.
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2025-12-30 | Initial format guide |