rootkid0-initializer 0.1.0

package/rootkid0-bootstrap/init-project.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+source "$SCRIPT_DIR/helpers.sh"
+
+print_usage() {
+  echo "Uso: ./rootkid0-bootstrap/init-project.sh [--setup-mcp] <project-name>"
+}
+
+SETUP_MCP=false
+PROJECT_NAME=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --setup-mcp)
+      SETUP_MCP=true
+      ;;
+    -h|--help)
+      print_usage
+      exit 0
+      ;;
+    *)
+      if [[ -z "$PROJECT_NAME" ]]; then
+        PROJECT_NAME="$arg"
+      else
+        echo "Error: argumento no reconocido '$arg'" >&2
+        print_usage
+        exit 1
+      fi
+      ;;
+  esac
+done
+
+if [[ -z "$PROJECT_NAME" ]]; then
+  read -r -p "Nombre del proyecto: " PROJECT_NAME
+fi
+
+validate_project_name "$PROJECT_NAME"
+
+DESTINATION="$PWD/$PROJECT_NAME"
+
+if [[ -e "$DESTINATION" ]]; then
+  echo "Error: Ya existe la carpeta $DESTINATION" >&2
+  exit 1
+fi
+
+echo "Creando proyecto: $PROJECT_NAME"
+mkdir -p "$DESTINATION"
+
+copy_baseline "$REPO_ROOT" "$DESTINATION"
+replace_project_placeholders "$DESTINATION" "$PROJECT_NAME"
+generate_project_readme "$DESTINATION" "$PROJECT_NAME"
+
+if [[ "$SETUP_MCP" == "true" ]]; then
+  setup_global_mcp_config "$REPO_ROOT"
+fi
+
+bash "$SCRIPT_DIR/notion-bootstrap.sh" --project-name "$PROJECT_NAME" --project-dir "$DESTINATION"
+
+echo
+echo "Proyecto creado en: $DESTINATION"
+echo "Siguientes pasos:"
+echo "  1) cd \"$PROJECT_NAME\""
+echo "  2) Completar 01-business/ a 07-production/"
+echo "  3) Ajustar 99-common/project.config.json"
+echo "  4) Revisar AGENTS.md y .opencode/README.md"
+echo "  5) Revisar 99-common/notion-bootstrap.output.json"

package/rootkid0-bootstrap/notion-bootstrap.ps1

@@ -0,0 +1,162 @@
+param(
+  [Parameter(Mandatory = $true)]
+  [string]$ProjectName,
+
+  [Parameter(Mandatory = $true)]
+  [string]$ProjectDir
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+function Fail([string]$Message) {
+  throw $Message
+}
+
+function Require-Env([string]$Name) {
+  $value = [Environment]::GetEnvironmentVariable($Name)
+  if ([string]::IsNullOrWhiteSpace($value)) {
+    Fail "Variable requerida no definida: $Name. Definila y vuelve a ejecutar init-project."
+  }
+}
+
+function Get-NotionPagePayload([string]$ParentPageId, [string]$Title) {
+  return @{
+    parent = @{ page_id = $ParentPageId }
+    properties = @{
+      title = @{
+        title = @(
+          @{
+            type = "text"
+            text = @{ content = $Title }
+          }
+        )
+      }
+    }
+  } | ConvertTo-Json -Depth 10
+}
+
+function New-NotionPage([string]$ParentPageId, [string]$Title) {
+  $headers = @{
+    Authorization    = "Bearer $env:NOTION_TOKEN"
+    "Notion-Version" = "2022-06-28"
+    "Content-Type"   = "application/json"
+  }
+
+  $body = Get-NotionPagePayload -ParentPageId $ParentPageId -Title $Title
+
+  try {
+    $response = Invoke-RestMethod -Method Post -Uri "https://api.notion.com/v1/pages" -Headers $headers -Body $body
+  }
+  catch {
+    $apiMessage = $_.ErrorDetails.Message
+    if ([string]::IsNullOrWhiteSpace($apiMessage)) {
+      $apiMessage = $_.Exception.Message
+    }
+    Fail "No se pudo crear pagina en Notion ($Title). Detalle: $apiMessage"
+  }
+
+  if ([string]::IsNullOrWhiteSpace($response.id)) {
+    Fail "Notion no devolvio un id valido al crear '$Title'."
+  }
+
+  return $response.id
+}
+
+if (-not (Test-Path -LiteralPath $ProjectDir)) {
+  Fail "No existe el directorio de proyecto: $ProjectDir"
+}
+
+$mcpFile = Join-Path $HOME ".config/opencode/mcp-servers.json"
+
+if (-not (Test-Path -LiteralPath $mcpFile)) {
+  Fail "No existe $mcpFile. Configura MCP global con servidor notion y vuelve a ejecutar init-project."
+}
+
+try {
+  $mcpConfig = Get-Content -Path $mcpFile -Raw | ConvertFrom-Json
+}
+catch {
+  Fail "El archivo $mcpFile no tiene JSON valido. Corrigelo y vuelve a ejecutar init-project."
+}
+
+if ($null -eq $mcpConfig.servers -or $null -eq $mcpConfig.servers.notion) {
+  Fail "Falta entrada servers.notion en $mcpFile. Agregala y vuelve a ejecutar init-project."
+}
+
+Require-Env "NOTION_TOKEN"
+Require-Env "NOTION_PARENT_PAGE_ID"
+
+$workspaceName = [Environment]::GetEnvironmentVariable("NOTION_WORKSPACE_NAME")
+
+Write-Host "Iniciando bootstrap automatico de Notion..."
+
+$rootTitle = $ProjectName
+if (-not [string]::IsNullOrWhiteSpace($workspaceName)) {
+  $rootTitle = "$workspaceName - $ProjectName"
+}
+
+$projectRootPageId = New-NotionPage -ParentPageId $env:NOTION_PARENT_PAGE_ID -Title $rootTitle
+Write-Host "Pagina raiz creada: $projectRootPageId"
+
+$phaseNames = @(
+  "01-business",
+  "02-proposal",
+  "03-design",
+  "04-management",
+  "05-development",
+  "06-deployment",
+  "07-production",
+  "99-common"
+)
+
+$phaseMap = [ordered]@{}
+$commonPageId = ""
+
+foreach ($phase in $phaseNames) {
+  $phaseId = New-NotionPage -ParentPageId $projectRootPageId -Title $phase
+  $phaseMap[$phase] = $phaseId
+  Write-Host "Pagina creada ($phase): $phaseId"
+  if ($phase -eq "99-common") {
+    $commonPageId = $phaseId
+  }
+}
+
+if ([string]::IsNullOrWhiteSpace($commonPageId)) {
+  Fail "No se pudo crear la pagina 99-common en Notion."
+}
+
+$sectionNames = @(
+  "Projects",
+  "Phases",
+  "Deliverables",
+  "Backlog",
+  "Risks",
+  "Decisions",
+  "Incidents"
+)
+
+$sectionMap = [ordered]@{}
+
+foreach ($section in $sectionNames) {
+  $sectionId = New-NotionPage -ParentPageId $commonPageId -Title $section
+  $sectionMap[$section] = $sectionId
+  Write-Host "Seccion modelo MVP creada ($section): $sectionId"
+}
+
+$outputPath = Join-Path $ProjectDir "99-common/notion-bootstrap.output.json"
+
+$result = [ordered]@{
+  project_name = $ProjectName
+  workspace_name = $workspaceName
+  created_at_utc = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+  notion_parent_page_id = $env:NOTION_PARENT_PAGE_ID
+  project_root_page_id = $projectRootPageId
+  phase_pages = $phaseMap
+  model_sections = $sectionMap
+}
+
+$result | ConvertTo-Json -Depth 10 | Set-Content -Path $outputPath
+
+Write-Host "Bootstrap Notion completado."
+Write-Host "Salida guardada en: $outputPath"

package/rootkid0-bootstrap/notion-bootstrap.sh

@@ -0,0 +1,301 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+print_usage() {
+  echo "Uso: ./rootkid0-bootstrap/notion-bootstrap.sh --project-name <name> --project-dir <path>"
+}
+
+fail() {
+  echo "Error: $1" >&2
+  exit 1
+}
+
+json_escape() {
+  local value="${1:-}"
+  value="${value//\\/\\\\}"
+  value="${value//\"/\\\"}"
+  value="${value//$'\n'/ }"
+  value="${value//$'\r'/ }"
+  printf '%s' "$value"
+}
+
+pick_python() {
+  if command -v python3 >/dev/null 2>&1; then
+    echo "python3"
+    return 0
+  fi
+
+  if command -v python >/dev/null 2>&1; then
+    echo "python"
+    return 0
+  fi
+
+  return 1
+}
+
+validate_mcp_config() {
+  local mcp_file="$HOME/.config/opencode/mcp-servers.json"
+  local py_bin
+  local py_status
+
+  if [[ ! -f "$mcp_file" ]]; then
+    fail "No existe $mcp_file. Configura el MCP global con entrada 'notion' y vuelve a ejecutar init-project."
+  fi
+
+  py_bin="$(pick_python || true)"
+
+  if [[ -n "$py_bin" ]]; then
+    if "$py_bin" - "$mcp_file" <<'PY'; then
+import json
+import sys
+
+path = sys.argv[1]
+try:
+    with open(path, "r", encoding="utf-8") as f:
+        data = json.load(f)
+except Exception:
+    sys.exit(2)
+
+servers = data.get("servers")
+if isinstance(servers, dict) and "notion" in servers:
+    sys.exit(0)
+
+sys.exit(1)
+PY
+      py_status=0
+    else
+      py_status=$?
+    fi
+
+    if [[ "$py_status" -ne 0 ]]; then
+      case "$py_status" in
+        1)
+          fail "Falta el servidor 'notion' en $mcp_file. Agrega la entrada en servers.notion y vuelve a ejecutar init-project."
+          ;;
+        2)
+          fail "El archivo $mcp_file no tiene JSON valido. Corrigelo y vuelve a ejecutar init-project."
+          ;;
+        *)
+          fail "No se pudo validar $mcp_file. Verifica permisos y formato del archivo."
+          ;;
+      esac
+    fi
+    return 0
+  fi
+
+  if ! grep -q '"notion"' "$mcp_file"; then
+    fail "No se detecto la entrada 'notion' en $mcp_file. Agrega el servidor notion y vuelve a ejecutar init-project."
+  fi
+}
+
+require_env() {
+  local var_name="$1"
+  local var_value="${!var_name:-}"
+
+  if [[ -z "$var_value" ]]; then
+    fail "Variable requerida no definida: $var_name. Exporta $var_name y vuelve a ejecutar init-project."
+  fi
+}
+
+require_command() {
+  local command_name="$1"
+  if ! command -v "$command_name" >/dev/null 2>&1; then
+    fail "Dependencia requerida no encontrada: $command_name. Instalala y vuelve a ejecutar init-project."
+  fi
+}
+
+build_page_payload() {
+  local parent_id="$1"
+  local title="$2"
+
+  printf '{"parent":{"page_id":"%s"},"properties":{"title":{"title":[{"type":"text","text":{"content":"%s"}}]}}}' \
+    "$parent_id" \
+    "$(json_escape "$title")"
+}
+
+create_notion_page() {
+  local parent_id="$1"
+  local title="$2"
+  local payload
+  local response_file
+  local status
+  local py_bin
+  local page_id
+
+  payload="$(build_page_payload "$parent_id" "$title")"
+  response_file="$(mktemp)"
+
+  status="$(curl -sS -o "$response_file" -w "%{http_code}" \
+    -X POST "https://api.notion.com/v1/pages" \
+    -H "Authorization: Bearer $NOTION_TOKEN" \
+    -H "Notion-Version: 2022-06-28" \
+    -H "Content-Type: application/json" \
+    --data "$payload")"
+
+  if [[ "$status" -lt 200 || "$status" -ge 300 ]]; then
+    local error_body
+    error_body="$(tr -d '\n' < "$response_file")"
+    rm -f "$response_file"
+    fail "Notion API devolvio HTTP $status al crear '$title'. Respuesta: $error_body"
+  fi
+
+  py_bin="$(pick_python || true)"
+  if [[ -n "$py_bin" ]]; then
+    page_id="$("$py_bin" - "$response_file" <<'PY'
+import json
+import sys
+
+with open(sys.argv[1], "r", encoding="utf-8") as f:
+    data = json.load(f)
+
+print(data.get("id", ""))
+PY
+)"
+  else
+    page_id="$(grep -o '"id":"[^"]*"' "$response_file" | head -n 1 | cut -d '"' -f 4)"
+  fi
+
+  rm -f "$response_file"
+
+  if [[ -z "$page_id" ]]; then
+    fail "No se pudo extraer el id de la pagina creada para '$title'."
+  fi
+
+  printf '%s' "$page_id"
+}
+
+PROJECT_NAME=""
+PROJECT_DIR=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --project-name)
+      PROJECT_NAME="${2:-}"
+      shift 2
+      ;;
+    --project-dir)
+      PROJECT_DIR="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      print_usage
+      exit 0
+      ;;
+    *)
+      fail "Argumento no reconocido: $1"
+      ;;
+  esac
+done
+
+if [[ -z "$PROJECT_NAME" || -z "$PROJECT_DIR" ]]; then
+  print_usage
+  fail "Debes indicar --project-name y --project-dir."
+fi
+
+if [[ ! -d "$PROJECT_DIR" ]]; then
+  fail "No existe el directorio de proyecto: $PROJECT_DIR"
+fi
+
+validate_mcp_config
+require_command "curl"
+require_env "NOTION_TOKEN"
+require_env "NOTION_PARENT_PAGE_ID"
+
+NOTION_WORKSPACE_NAME="${NOTION_WORKSPACE_NAME:-}"
+
+echo "Iniciando bootstrap automatico de Notion..."
+
+root_title="$PROJECT_NAME"
+if [[ -n "$NOTION_WORKSPACE_NAME" ]]; then
+  root_title="$NOTION_WORKSPACE_NAME - $PROJECT_NAME"
+fi
+
+project_root_page_id="$(create_notion_page "$NOTION_PARENT_PAGE_ID" "$root_title")"
+echo "Pagina raiz creada: $project_root_page_id"
+
+phase_names=(
+  "01-business"
+  "02-proposal"
+  "03-design"
+  "04-management"
+  "05-development"
+  "06-deployment"
+  "07-production"
+  "99-common"
+)
+
+phase_ids=()
+common_page_id=""
+
+for phase in "${phase_names[@]}"; do
+  phase_id="$(create_notion_page "$project_root_page_id" "$phase")"
+  phase_ids+=("$phase_id")
+  echo "Pagina creada ($phase): $phase_id"
+  if [[ "$phase" == "99-common" ]]; then
+    common_page_id="$phase_id"
+  fi
+done
+
+if [[ -z "$common_page_id" ]]; then
+  fail "No se pudo crear la pagina 99-common en Notion."
+fi
+
+section_names=(
+  "Projects"
+  "Phases"
+  "Deliverables"
+  "Backlog"
+  "Risks"
+  "Decisions"
+  "Incidents"
+)
+
+section_ids=()
+for section in "${section_names[@]}"; do
+  section_id="$(create_notion_page "$common_page_id" "$section")"
+  section_ids+=("$section_id")
+  echo "Seccion modelo MVP creada ($section): $section_id"
+done
+
+output_file="$PROJECT_DIR/99-common/notion-bootstrap.output.json"
+timestamp_utc="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+{
+  echo "{"
+  echo "  \"project_name\": \"$(json_escape "$PROJECT_NAME")\","
+  echo "  \"workspace_name\": \"$(json_escape "$NOTION_WORKSPACE_NAME")\","
+  echo "  \"created_at_utc\": \"$timestamp_utc\","
+  echo "  \"notion_parent_page_id\": \"$(json_escape "$NOTION_PARENT_PAGE_ID")\","
+  echo "  \"project_root_page_id\": \"$project_root_page_id\","
+  echo "  \"phase_pages\": {"
+
+  for i in "${!phase_names[@]}"; do
+    key="${phase_names[$i]}"
+    value="${phase_ids[$i]}"
+    suffix=","
+    if [[ "$i" -eq $((${#phase_names[@]} - 1)) ]]; then
+      suffix=""
+    fi
+    echo "    \"$(json_escape "$key")\": \"$value\"$suffix"
+  done
+
+  echo "  },"
+  echo "  \"model_sections\": {"
+
+  for i in "${!section_names[@]}"; do
+    key="${section_names[$i]}"
+    value="${section_ids[$i]}"
+    suffix=","
+    if [[ "$i" -eq $((${#section_names[@]} - 1)) ]]; then
+      suffix=""
+    fi
+    echo "    \"$(json_escape "$key")\": \"$value\"$suffix"
+  done
+
+  echo "  }"
+  echo "}"
+} > "$output_file"
+
+echo "Bootstrap Notion completado."
+echo "Salida guardada en: $output_file"

package/rootkid0-bootstrap/skills/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: local-bootstrap-conventions
+description: Convenciones para scripts de bootstrap. Trigger: cambios en rootkid0-bootstrap.
+---
+
+# Skill local rootkid0-bootstrap
+
+- Cuidar validaciones de nombre y rutas.
+- No introducir dependencias innecesarias.