@dsalazardev/ai-hub-cli 0.0.0-stage → 0.2.0

package/manifest.json

@@ -0,0 +1,402 @@
+{
+  "version": 2,
+  "generatedBy": "@dsalazardev/ai-hub-cli",
+  "project": {
+    "id": "ai-hub",
+    "name": "AI Hub"
+  },
+  "preset": {
+    "id": "generic-ts",
+    "version": 1
+  },
+  "engine": {
+    "roles": 8,
+    "commands": 17,
+    "labels": 7
+  },
+  "roles": [
+    "implementer-backend",
+    "implementer-frontend",
+    "prompt-explorer",
+    "reviewer-architecture",
+    "reviewer-exploration",
+    "reviewer-tests",
+    "spec-author",
+    "spec-explorer"
+  ],
+  "commands": [
+    {
+      "id": "analyze",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-analyze"
+    },
+    {
+      "id": "assess-decide",
+      "lane": "assessment",
+      "role": "spec-explorer",
+      "skill": "speckit-assess-decide"
+    },
+    {
+      "id": "assess-define",
+      "lane": "assessment",
+      "role": "spec-explorer",
+      "skill": "speckit-assess-define"
+    },
+    {
+      "id": "assess-intake",
+      "lane": "assessment",
+      "role": "spec-explorer",
+      "skill": "speckit-assess-intake"
+    },
+    {
+      "id": "assess-research",
+      "lane": "assessment",
+      "role": "spec-explorer",
+      "skill": "speckit-assess-research"
+    },
+    {
+      "id": "assess-shape",
+      "lane": "assessment",
+      "role": "spec-explorer",
+      "skill": "speckit-assess-shape"
+    },
+    {
+      "id": "bug-assess",
+      "lane": "bug",
+      "role": "reviewer-architecture",
+      "skill": "speckit-bug-assess"
+    },
+    {
+      "id": "bug-fix",
+      "lane": "bug",
+      "role": "implementer-backend",
+      "skill": "speckit-bug-fix"
+    },
+    {
+      "id": "bug-test",
+      "lane": "bug",
+      "role": "reviewer-tests",
+      "skill": "speckit-bug-test"
+    },
+    {
+      "id": "checklist",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-checklist"
+    },
+    {
+      "id": "clarify",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-clarify"
+    },
+    {
+      "id": "constitution",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-constitution"
+    },
+    {
+      "id": "converge",
+      "lane": "feature",
+      "role": "reviewer-architecture",
+      "skill": "speckit-converge"
+    },
+    {
+      "id": "implement",
+      "lane": "feature",
+      "role": "implementer-frontend",
+      "skill": "speckit-implement"
+    },
+    {
+      "id": "plan",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-plan"
+    },
+    {
+      "id": "specify",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-specify"
+    },
+    {
+      "id": "tasks",
+      "lane": "feature",
+      "role": "spec-author",
+      "skill": "speckit-tasks"
+    }
+  ],
+  "labels": [
+    "ai::blocked",
+    "ai::done",
+    "ai::in-dev",
+    "ai::in-review",
+    "ai::in-spec",
+    "ai::spec-ready",
+    "ai::todo"
+  ],
+  "targets": [
+    "claude",
+    "copilot",
+    "cursor",
+    "opencode",
+    "pi"
+  ],
+  "selection": {
+    "skills": "full",
+    "agents": "full",
+    "rules": "custom"
+  },
+  "catalog": {
+    "version": "0.2.0",
+    "hash": "f30e2590a4eb078ea520873661b5f10fb3cf9171d1422438c35aafd722abbb23"
+  },
+  "agents": [
+    "cpp-build-resolver",
+    "cpp-reviewer",
+    "csharp-reviewer",
+    "django-build-resolver",
+    "django-reviewer",
+    "explorer-domain",
+    "fastapi-reviewer",
+    "flutter-build-resolver",
+    "flutter-reviewer",
+    "go-build-resolver",
+    "go-reviewer",
+    "implementer-backend",
+    "implementer-frontend",
+    "java-build-resolver",
+    "java-reviewer",
+    "kotlin-build-resolver",
+    "kotlin-reviewer",
+    "mle-reviewer",
+    "php-reviewer",
+    "postgres-reviewer",
+    "python-reviewer",
+    "pytorch-build-resolver",
+    "rag-reviewer",
+    "react-build-resolver",
+    "react-reviewer",
+    "reviewer-architecture",
+    "reviewer-tests",
+    "rust-build-resolver",
+    "rust-reviewer",
+    "spec-author",
+    "spec-miner",
+    "swift-build-resolver",
+    "swift-reviewer",
+    "typescript-reviewer",
+    "vue-reviewer"
+  ],
+  "skills": [
+    "ab-testing",
+    "accessibility",
+    "agent-eval",
+    "agent-safety",
+    "analyze",
+    "angular",
+    "api-connector-builder",
+    "api-design",
+    "astro",
+    "author-skill",
+    "automation-flows",
+    "aws-essentials",
+    "backups",
+    "bash-scripting",
+    "building-agents",
+    "chatbot",
+    "chrome-extension",
+    "clarify",
+    "clickhouse-analytics",
+    "cloudflare",
+    "code-review",
+    "codebase-onboarding",
+    "compose-multiplatform",
+    "connect-tool",
+    "constitution",
+    "context-budget",
+    "continuous-learning",
+    "coolify",
+    "cost-tracking",
+    "cpp",
+    "csharp-dotnet",
+    "data-cleaning",
+    "data-scraper",
+    "db-migrations",
+    "debug",
+    "decision-challenge",
+    "decision-records",
+    "deep-learning",
+    "deployment",
+    "deprecation",
+    "design",
+    "digitalocean",
+    "django",
+    "docker",
+    "domains-dns",
+    "drizzle-orm",
+    "duckdb",
+    "dynamodb",
+    "e2e-testing",
+    "electron",
+    "elixir",
+    "email-deliverability",
+    "embeddings-search",
+    "error-handling",
+    "expo",
+    "fal",
+    "fastapi",
+    "finetuning",
+    "firebase",
+    "flutter",
+    "fly-io",
+    "ftd",
+    "game-design",
+    "game-storytelling",
+    "gamedev-multiplayer",
+    "gamedev-pathing",
+    "gamedev-physics",
+    "gamedev-shaders",
+    "gamedev-shipping",
+    "gcp-essentials",
+    "git-workflow",
+    "github-actions",
+    "gitlab-auth",
+    "gitlab-workflow",
+    "go",
+    "godot",
+    "harness",
+    "hetzner",
+    "htmx",
+    "huggingface",
+    "idea-refinement",
+    "implement",
+    "init",
+    "java",
+    "knowledge-ops",
+    "kotlin-android",
+    "laravel",
+    "level-design",
+    "llm-pipeline",
+    "machine-learning",
+    "modal",
+    "mongodb",
+    "monitoring",
+    "mysql",
+    "neon",
+    "nestjs",
+    "netlify",
+    "nextjs",
+    "nlp",
+    "no-code-app",
+    "nodejs",
+    "observability",
+    "ollama",
+    "open-weights",
+    "orient",
+    "parallel",
+    "performance",
+    "phoenix",
+    "php",
+    "plan",
+    "planetscale",
+    "planning-with-files",
+    "postgresdb",
+    "prisma-orm",
+    "prompt-engineering",
+    "python",
+    "rag",
+    "rails",
+    "railway",
+    "react",
+    "react-native",
+    "redis",
+    "render",
+    "replicate",
+    "research-ops",
+    "review",
+    "ruby",
+    "runpod",
+    "rust",
+    "scaling",
+    "sdd",
+    "sdd-init",
+    "secure-coding",
+    "security-scan",
+    "ship",
+    "shopify",
+    "simplify-code",
+    "skill-scout",
+    "solid-js",
+    "source-grounded-development",
+    "specify",
+    "speckit-analyze",
+    "speckit-assess-decide",
+    "speckit-assess-define",
+    "speckit-assess-intake",
+    "speckit-assess-research",
+    "speckit-assess-shape",
+    "speckit-bug-assess",
+    "speckit-bug-fix",
+    "speckit-bug-test",
+    "speckit-checklist",
+    "speckit-clarify",
+    "speckit-constitution",
+    "speckit-converge",
+    "speckit-implement",
+    "speckit-plan",
+    "speckit-specify",
+    "speckit-tasks",
+    "spreadsheet-ops",
+    "spring-boot",
+    "sql",
+    "sqlite-turso",
+    "structured-extraction",
+    "suggest",
+    "supabase",
+    "svelte",
+    "swift-ios",
+    "tasks",
+    "tauri",
+    "technical-writing",
+    "testing-go",
+    "testing-py",
+    "testing-web",
+    "together-fireworks",
+    "training-data",
+    "translation-l10n",
+    "typescript",
+    "ui-engineering",
+    "unity",
+    "unreal",
+    "unslop",
+    "unsloth",
+    "variant-explorer",
+    "vector-db",
+    "vercel",
+    "verify",
+    "vllm",
+    "vue-nuxt",
+    "webhooks",
+    "wordpress",
+    "worktrees"
+  ],
+  "rules": [
+    "engine-core",
+    "skill-quality/skill-behavior-rubric",
+    "skill-quality/skill-harden-rubric",
+    "skill-quality/skill-migration-brief",
+    "skill-quality/skill-rubric"
+  ],
+  "counts": {
+    "roles": 8,
+    "commands": 17,
+    "labels": 7,
+    "targets": 5,
+    "agents": 35,
+    "skills": 191,
+    "rules": 5
+  }
+}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@dsalazardev/ai-hub-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "author": "Daner Alejandro Salazar Colorado",
+  "license": "MIT",
+  "type": "module",
+  "description": "AI Hub CLI — arnés agéntico instalable: bootstrap de .ai-hub/, preset por detección, sync multi-target, doctor y guardias.",
+  "keywords": [
+    "ai",
+    "agents",
+    "harness",
+    "software-factory",
+    "spec-kit",
+    "cli",
+    "scaffolding"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsalazardev/ai-hub.git"
+  },
+  "homepage": "https://github.com/dsalazardev/ai-hub#readme",
+  "bugs": {
+    "url": "https://github.com/dsalazardev/ai-hub/issues"
+  },
+  "bin": {
+    "ai-hub": "dist/bin/ai-hub.js"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "manifest.json",
+    "engine",
+    "presets",
+    "rules",
+    "agents",
+    "skills",
+    "LICENSE",
+    "NOTICE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "manifest:build": "node dist/manifest/cli.js",
+    "manifest:check": "node dist/manifest/cli.js --check",
+    "prepublishOnly": "npm run build && npm run manifest:build && npm test"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "yaml": "2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/presets/angular-express/harness/rules/01-zero-any.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Regla: Zero-Any — Prohibido `: any` en archivos TypeScript (excepto tests)
+# Nivel: L2
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+violations=$(grep -rn ": any\b" \
+  --include='*.ts' \
+  "$PROJECT_ROOT/frontend/src" \
+  "$PROJECT_ROOT/backend/src" \
+  2>/dev/null | grep -v "\.spec\.ts\|\.test\.ts" || true)
+
+if [[ -n "$violations" ]]; then
+  count=$(echo "$violations" | wc -l | tr -d ' ')
+  printf '\033[0;33m[WARN]\033[0m  zero-any — %s ocurrencia(s) de '\'': any'\'' detectada(s).\n' "$count"
+  printf '       Se permite por excepciones validas (DALs, catch blocks), pero es una mala practica.\n'
+  printf '       Debe resolverse progresivamente. Usa '\''unknown'\'' con type guards donde sea posible.\n'
+  echo "$violations"
+  exit 0
+fi
+echo "[OK]   zero-any"
+exit 0

package/presets/angular-express/harness/rules/02-no-ng-module.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Regla: No-NgModule — Prohibido @NgModule en componentes Angular
+# Nivel: L2
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+violations=$(grep -rn "@NgModule\|NgModule({" \
+  --include='*.ts' \
+  "$PROJECT_ROOT/frontend/src" \
+  2>/dev/null || true)
+
+if [[ -n "$violations" ]]; then
+  echo "[FAIL] no-ng-module"
+  echo "$violations"
+  exit 1
+fi
+echo "[OK]   no-ng-module"
+exit 0

package/presets/angular-express/harness/rules/03-no-constructor-injection.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Regla: No-Constructor-Injection — Solo inject() permitido, no DI via constructor
+# Nivel: L2
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+violations=$(grep -rPn "constructor\s*\([^)]*(?:private|public|protected|readonly)\s+\w" \
+  --include='*.ts' \
+  "$PROJECT_ROOT/frontend/src" \
+  2>/dev/null | grep -v "\.spec\.ts\|\.test\.ts" || true)
+
+if [[ -n "$violations" ]]; then
+  echo "[FAIL] no-constructor-injection"
+  echo "$violations"
+  exit 1
+fi
+echo "[OK]   no-constructor-injection"
+exit 0

package/presets/angular-express/harness/rules/04-no-legacy-directives.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Regla: No-Legacy-Directives — Prohibido *ngIf, *ngFor, *ngSwitch (usar @if, @for, @switch)
+# Nivel: L2
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+violations=$(grep -rn "\*ngIf\|\*ngFor\|\*ngSwitch" \
+  --include='*.html' \
+  "$PROJECT_ROOT/frontend/src" \
+  2>/dev/null || true)
+
+if [[ -n "$violations" ]]; then
+  echo "[FAIL] no-legacy-directives"
+  echo "$violations"
+  exit 1
+fi
+echo "[OK]   no-legacy-directives"
+exit 0

package/presets/angular-express/harness/rules/05-no-dolibarrdal-inheritance.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Regla: No-DolibarrDal-Inheritance — Herencia de DolibarrDal solo en infrastructure/dal/dolibarr/
+# Nivel: L2
+#
+# G2: Los DALs segregados (uno por endpoint) DEBEN heredar de DolibarrDal para acceder a helpers
+#     protegidos (combineSqlFilters, mapFiltersFromDomain, this.dolibarr.*). Esto es correcto.
+# Prohibido: heredar de DolibarrDal fuera de infrastructure/dal/dolibarr/ (services, routes, etc.)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+violations=$(grep -rn "extends DolibarrDal" \
+  --include='*.ts' \
+  "$PROJECT_ROOT/backend/src" \
+  2>/dev/null | grep -v "infrastructure/dal/dolibarr/" || true)
+
+if [[ -n "$violations" ]]; then
+  echo "[FAIL] no-dolibarrdal-inheritance"
+  echo "$violations"
+  exit 1
+fi
+echo "[OK]   no-dolibarrdal-inheritance"
+exit 0

package/presets/angular-express/harness/rules/06-no-todos.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Regla: No-TODOs — Prohibidos TODO en codigo de produccion (excepto TODO(test))
+# Nivel: L2
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+
+violations=$(grep -rPn "\bTODO\b(?!\(test\))" \
+  --include='*.ts' \
+  "$PROJECT_ROOT/frontend/src" \
+  "$PROJECT_ROOT/backend/src" \
+  2>/dev/null | grep -v "\.spec\.ts\|\.test\.ts" || true)
+
+if [[ -n "$violations" ]]; then
+  echo "[FAIL] no-todos"
+  echo "$violations"
+  exit 1
+fi
+echo "[OK]   no-todos"
+exit 0

package/presets/angular-express/harness/run-all.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Project-level checks for the angular-express preset.
+set -u
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+cd "$ROOT" || exit 1
+status=0
+for rule in .ai-hub/harness/rules/*.sh; do
+  [ -f "$rule" ] || continue
+  if ! bash "$rule"; then
+    status=1
+  fi
+done
+exit "$status"

package/presets/angular-express/preset.yaml

@@ -0,0 +1,53 @@
+id: angular-express
+version: 1
+extends: generic-ts
+description: Angular frontend with an Express BFF, Vitest and an optional Dolibarr-style REST backend.
+# Sin detect: preset de cliente. Sólo se elige con --preset angular-express.
+stack:
+  languages:
+    - typescript
+  frontend: angular
+  backend: express
+  packageManager: npm
+commands:
+  install: npm ci
+  build: npm run build
+  test: npm test
+  typecheck: npx tsc --noEmit
+  lint: npm run lint
+  verify: bash .ai-hub/harness/run-all.sh
+paths:
+  source:
+    - frontend/src
+    - backend/src
+  tests:
+    - "**/*.spec.ts"
+    - "**/*.test.ts"
+  docs:
+    - docs
+policy:
+  trunk: auto
+  guardMode: shadow
+  worktrees: true
+  optOuts: []
+rules:
+  - rules/frontend.md
+  - rules/backend.md
+  - rules/architecture.md
+agents:
+  publish:
+    - spec-author
+    - implementer-frontend
+    - implementer-backend
+    - reviewer-architecture
+    - reviewer-tests
+    - explorer-domain
+skills:
+  publish:
+    - angular-developer
+    - angular-new-app
+    - frontend-design
+    - onna-architecture-angular
+    - onna-architecture-bff
+    - onna-architecture-common
+    - onna-design-system