@mestreyoda/fabrica 0.1.0

package/fabrica.manifest.json

@@ -0,0 +1,24 @@
+{
+  "layoutVersion": "fabrica-v1",
+  "assets": {
+    "defaultsDir": "defaults",
+    "promptsDir": "defaults/fabrica/prompts",
+    "securityChecklistPath": "defaults/fabrica/prompts/security-checklist.md",
+    "workflowPath": "defaults/fabrica/workflow.yaml",
+    "templatesDir": "defaults",
+    "genesis": {
+      "root": "genesis",
+      "scriptsDir": "genesis/scripts",
+      "configsDir": "genesis/configs"
+    },
+    "migrations": [
+      "layout",
+      "workflow"
+    ]
+  },
+  "layout": {
+    "primaryDataDir": "fabrica",
+    "legacyDataDir": "devclaw",
+    "versionFile": ".layout-version"
+  }
+}

package/genesis/configs/classification-rules.json

@@ -0,0 +1,32 @@
+{
+  "version": "1.0",
+  "default_type": "feature",
+  "confidence_threshold": 0.6,
+  "types": {
+    "bugfix": {
+      "keywords": ["bug", "fix", "erro", "error", "crash", "broken", "quebrado", "falha", "fail", "exception", "not working", "nao funciona", "não funciona", "regression", "regressão"],
+      "patterns": ["(?i)\\b(fix|corrig|resolv|repair|patch)\\b", "(?i)\\b(bug|erro|falha|crash|quebr)\\b"],
+      "weight": 1.2
+    },
+    "feature": {
+      "keywords": ["add", "create", "new", "implement", "build", "fazer", "criar", "adicionar", "novo", "nova", "implementar", "construir", "develop", "desenvolver", "want", "quero", "need", "preciso"],
+      "patterns": ["(?i)\\b(add|creat|implement|build|desenvolv|faz)\\b", "(?i)\\b(nov[oa]|new)\\b"],
+      "weight": 1.0
+    },
+    "refactor": {
+      "keywords": ["refactor", "refatorar", "cleanup", "clean up", "reorganize", "reorganizar", "simplify", "simplificar", "extract", "extrair", "rename", "renomear", "move", "mover", "split", "dividir", "merge", "consolidar"],
+      "patterns": ["(?i)\\b(refactor|refator|cleanup|reorganiz|simplif)\\b", "(?i)\\b(extract|split|merg|consolid)\\b"],
+      "weight": 0.9
+    },
+    "research": {
+      "keywords": ["research", "pesquisar", "investigate", "investigar", "explore", "explorar", "evaluate", "avaliar", "compare", "comparar", "spike", "poc", "proof of concept", "prova de conceito", "prototype", "protótipo", "study", "estudar"],
+      "patterns": ["(?i)\\b(research|pesquis|investigat|explor|avaliar|compar)\\b", "(?i)\\b(spike|poc|proof.of.concept|prova.de.conceito|protot)\\b"],
+      "weight": 0.8
+    },
+    "infra": {
+      "keywords": ["deploy", "ci", "cd", "pipeline", "docker", "kubernetes", "k8s", "terraform", "ansible", "monitoring", "monitoramento", "logging", "infrastructure", "infraestrutura", "devops", "server", "servidor", "database", "banco de dados", "migration", "migração", "config", "configuração", "env", "environment", "ambiente"],
+      "patterns": ["(?i)\\b(deploy|docker|k8s|kubernetes|terraform|ansible|ci.?cd)\\b", "(?i)\\b(infra|devops|pipeline|migration|migra[çc])\\b"],
+      "weight": 0.9
+    }
+  }
+}

package/genesis/configs/interview-templates.json

@@ -0,0 +1,73 @@
+{
+  "version": "1.0",
+  "max_rounds": 2,
+  "types": {
+    "feature": {
+      "round1": [
+        { "id": "f1", "question": "Qual problema específico essa feature resolve para o usuário?", "required": true, "follow_up_if_vague": "Pode dar um exemplo concreto de quando o usuário sentiria falta dessa funcionalidade?" },
+        { "id": "f2", "question": "Quem vai usar isso? Descreva o perfil do usuário principal.", "required": true, "follow_up_if_vague": "É um usuário final, admin, desenvolvedor, ou outro perfil?" },
+        { "id": "f3", "question": "Qual é o fluxo principal? O que o usuário faz passo a passo?", "required": true, "follow_up_if_vague": "Tente descrever: 'O usuário clica em X, preenche Y, vê Z'." },
+        { "id": "f4", "question": "Existe alguma restrição de tecnologia, prazo ou compatibilidade?", "required": false, "follow_up_if_vague": null },
+        { "id": "f5", "question": "Esse fluxo exige login? Se sim, quais perfis existem e quais permissões cada perfil deve ter?", "required": false, "follow_up_if_vague": "Descreva pelo menos um exemplo de ação permitida e uma ação bloqueada por perfil." }
+      ],
+      "technical_additions": [
+        { "id": "ft1", "question": "Quais APIs ou serviços externos essa feature precisa consumir?", "required": false },
+        { "id": "ft2", "question": "Há requisitos de performance (latência, throughput)?", "required": false },
+        { "id": "ft3", "question": "Qual o modelo de dados? Precisa de novas tabelas/coleções?", "required": false }
+      ],
+      "non_technical_additions": [
+        { "id": "fn1", "question": "Como você saberia que essa feature está funcionando bem? O que muda na sua rotina?", "required": false }
+      ]
+    },
+    "bugfix": {
+      "round1": [
+        { "id": "b1", "question": "O que está acontecendo de errado? Descreva o comportamento atual.", "required": true, "follow_up_if_vague": "Você vê alguma mensagem de erro? O que aparece na tela?" },
+        { "id": "b2", "question": "O que deveria acontecer? Qual o comportamento esperado?", "required": true, "follow_up_if_vague": "Antes funcionava corretamente? Quando parou?" },
+        { "id": "b3", "question": "Como reproduzir o bug? Passos exatos.", "required": true, "follow_up_if_vague": "Em qual página/tela? Com qual tipo de dado?" },
+        { "id": "b4", "question": "Com que frequência acontece? Sempre, às vezes, em condições específicas?", "required": false, "follow_up_if_vague": null }
+      ],
+      "technical_additions": [
+        { "id": "bt1", "question": "Em qual ambiente ocorre? (produção, staging, local)", "required": false },
+        { "id": "bt2", "question": "Tem logs ou stack trace disponível?", "required": false }
+      ],
+      "non_technical_additions": [
+        { "id": "bn1", "question": "Quantas pessoas são afetadas por esse problema?", "required": false }
+      ]
+    },
+    "refactor": {
+      "round1": [
+        { "id": "r1", "question": "Qual parte do código precisa ser refatorada? Qual módulo/arquivo?", "required": true, "follow_up_if_vague": "Qual funcionalidade está nesse código?" },
+        { "id": "r2", "question": "Qual o problema atual? (duplicação, complexidade, acoplamento, performance)", "required": true, "follow_up_if_vague": "O que dificulta trabalhar nesse código hoje?" },
+        { "id": "r3", "question": "Qual o resultado esperado da refatoração?", "required": true, "follow_up_if_vague": "Quer que fique mais legível, mais rápido, ou mais testável?" }
+      ],
+      "technical_additions": [
+        { "id": "rt1", "question": "A refatoração pode mudar interfaces públicas/APIs?", "required": false },
+        { "id": "rt2", "question": "Há testes existentes cobrindo esse código?", "required": false }
+      ],
+      "non_technical_additions": []
+    },
+    "research": {
+      "round1": [
+        { "id": "s1", "question": "O que precisa ser investigado ou avaliado?", "required": true, "follow_up_if_vague": "É uma tecnologia, abordagem, ou viabilidade de algo?" },
+        { "id": "s2", "question": "Qual decisão essa pesquisa vai informar?", "required": true, "follow_up_if_vague": "O que muda se a conclusão for positiva vs negativa?" },
+        { "id": "s3", "question": "Quais critérios definem sucesso da pesquisa?", "required": true, "follow_up_if_vague": "Qual entregável esperado? Documento, PoC, comparativo?" }
+      ],
+      "technical_additions": [
+        { "id": "st1", "question": "Há restrições de stack ou compatibilidade a considerar?", "required": false }
+      ],
+      "non_technical_additions": []
+    },
+    "infra": {
+      "round1": [
+        { "id": "i1", "question": "O que precisa ser configurado/implantado/migrado?", "required": true, "follow_up_if_vague": "É CI/CD, deploy, banco de dados, monitoramento?" },
+        { "id": "i2", "question": "Qual o ambiente alvo? (produção, staging, dev, local)", "required": true, "follow_up_if_vague": null },
+        { "id": "i3", "question": "Há requisitos de downtime, rollback ou compatibilidade?", "required": false, "follow_up_if_vague": null }
+      ],
+      "technical_additions": [
+        { "id": "it1", "question": "Quais serviços/ferramentas estão envolvidos?", "required": false },
+        { "id": "it2", "question": "Há secrets ou credenciais que precisam ser provisionadas?", "required": false }
+      ],
+      "non_technical_additions": []
+    }
+  }
+}

package/genesis/configs/labels.json

@@ -0,0 +1,202 @@
+[
+  {
+    "name": "Planning",
+    "color": "95a5a6",
+    "description": "Issue in planning phase"
+  },
+  {
+    "name": "To Do",
+    "color": "428bca",
+    "description": "Ready for development"
+  },
+  {
+    "name": "Doing",
+    "color": "f0ad4e",
+    "description": "In progress"
+  },
+  {
+    "name": "To Review",
+    "color": "7057ff",
+    "description": "Awaiting code review"
+  },
+  {
+    "name": "Reviewing",
+    "color": "c5def5",
+    "description": "Review in progress"
+  },
+  {
+    "name": "To Test",
+    "color": "5bc0de",
+    "description": "Awaiting QA testing"
+  },
+  {
+    "name": "Testing",
+    "color": "9b59b6",
+    "description": "Testing in progress"
+  },
+  {
+    "name": "Done",
+    "color": "5cb85c",
+    "description": "Completed"
+  },
+  {
+    "name": "Rejected",
+    "color": "e11d48",
+    "description": "Rejected"
+  },
+  {
+    "name": "To Improve",
+    "color": "d9534f",
+    "description": "Changes requested"
+  },
+  {
+    "name": "Refining",
+    "color": "f39c12",
+    "description": "Needs refinement"
+  },
+  {
+    "name": "To Research",
+    "color": "0075ca",
+    "description": "Needs investigation"
+  },
+  {
+    "name": "Researching",
+    "color": "4a90e2",
+    "description": "Research in progress"
+  },
+  {
+    "name": "approved",
+    "color": "0e8a16",
+    "description": "Approved for dispatch"
+  },
+  {
+    "name": "review:agent",
+    "color": "d93f0b",
+    "description": "Review by agent"
+  },
+  {
+    "name": "review:human",
+    "color": "d93f0b",
+    "description": "Review by human"
+  },
+  {
+    "name": "review:skip",
+    "color": "d93f0b",
+    "description": "Skip review"
+  },
+  {
+    "name": "test:skip",
+    "color": "d93f0b",
+    "description": "Skip testing"
+  },
+  {
+    "name": "type:feature",
+    "color": "0E8A16",
+    "description": "Feature request"
+  },
+  {
+    "name": "type:bugfix",
+    "color": "D93F0B",
+    "description": "Bug fix"
+  },
+  {
+    "name": "type:refactor",
+    "color": "FBCA04",
+    "description": "Code refactoring"
+  },
+  {
+    "name": "type:research",
+    "color": "0075CA",
+    "description": "Research/investigation"
+  },
+  {
+    "name": "type:infra",
+    "color": "5319E7",
+    "description": "Infrastructure/DevOps"
+  },
+  {
+    "name": "priority:critical",
+    "color": "B60205",
+    "description": "P0 - Critical"
+  },
+  {
+    "name": "priority:high",
+    "color": "D93F0B",
+    "description": "P1 - High"
+  },
+  {
+    "name": "priority:medium",
+    "color": "FBCA04",
+    "description": "P2 - Medium"
+  },
+  {
+    "name": "priority:normal",
+    "color": "0E8A16",
+    "description": "P3 - Normal"
+  },
+  {
+    "name": "effort:small",
+    "color": "C2E0C6",
+    "description": "≤3 files, ≤3 ACs"
+  },
+  {
+    "name": "effort:medium",
+    "color": "FEF2C0",
+    "description": "≤10 files, ≤7 ACs"
+  },
+  {
+    "name": "effort:large",
+    "color": "F9D0C4",
+    "description": "≤25 files, ≤15 ACs"
+  },
+  {
+    "name": "developer:junior",
+    "color": "0e8a16",
+    "description": ""
+  },
+  {
+    "name": "developer:medior",
+    "color": "0e8a16",
+    "description": ""
+  },
+  {
+    "name": "developer:senior",
+    "color": "0e8a16",
+    "description": ""
+  },
+  {
+    "name": "reviewer:junior",
+    "color": "d93f0b",
+    "description": ""
+  },
+  {
+    "name": "reviewer:senior",
+    "color": "d93f0b",
+    "description": ""
+  },
+  {
+    "name": "tester:junior",
+    "color": "5319e7",
+    "description": ""
+  },
+  {
+    "name": "tester:medior",
+    "color": "5319e7",
+    "description": ""
+  },
+  {
+    "name": "tester:senior",
+    "color": "5319e7",
+    "description": ""
+  },
+  {
+    "name": "needs-human",
+    "color": "d73a4a",
+    "description": "Requires human intervention"
+  },
+  {
+    "name": "effort:xlarge",
+    "color": "BFD4F2",
+    "description": ">25 files or >15 ACs"
+  }
+]

package/genesis/configs/triage-matrix.json

@@ -0,0 +1,39 @@
+{
+  "version": "1.0",
+  "priority_rules": [
+    { "condition": "type == 'bugfix' && risk_count > 2", "priority": "P0", "label": "priority:critical" },
+    { "condition": "type == 'bugfix'", "priority": "P1", "label": "priority:high" },
+    { "condition": "type == 'feature' && effort == 'small'", "priority": "P2", "label": "priority:medium" },
+    { "condition": "type == 'feature'", "priority": "P3", "label": "priority:normal" },
+    { "condition": "type == 'refactor'", "priority": "P3", "label": "priority:normal" },
+    { "condition": "type == 'infra'", "priority": "P2", "label": "priority:medium" },
+    { "condition": "type == 'research'", "priority": "P3", "label": "priority:normal" }
+  ],
+  "priority_rules_v2": [
+    { "when": { "type": "bugfix", "min_risk_count": 3 }, "priority": "P0", "label": "priority:critical" },
+    { "when": { "type": "bugfix" }, "priority": "P1", "label": "priority:high" },
+    { "when": { "type": "feature", "effort": "small" }, "priority": "P2", "label": "priority:medium" },
+    { "when": { "type": "feature" }, "priority": "P3", "label": "priority:normal" },
+    { "when": { "type": "refactor" }, "priority": "P3", "label": "priority:normal" },
+    { "when": { "type": "infra" }, "priority": "P2", "label": "priority:medium" },
+    { "when": { "type": "research" }, "priority": "P3", "label": "priority:normal" }
+  ],
+  "effort_rules": {
+    "small":  { "max_files": 3,  "max_acs": 3,  "label": "effort:small" },
+    "medium": { "max_files": 10, "max_acs": 7,  "label": "effort:medium" },
+    "large":  { "max_files": 25, "max_acs": 15, "label": "effort:large" },
+    "xlarge": { "max_files": 999, "max_acs": 999, "label": "effort:xlarge" }
+  },
+  "auto_labels": {
+    "feature":  "type:feature",
+    "bugfix":   "type:bugfix",
+    "refactor":  "type:refactor",
+    "research": "type:research",
+    "infra":    "type:infra"
+  },
+  "target_state_by_type": {
+    "default": "To Do",
+    "research": "To Research"
+  },
+  "dispatch_label": "approved"
+}

package/genesis/scripts/classify-idea.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Step 2: Classify idea type
+# Input: stdin JSON (from receive-idea.sh)
+# Output: JSON with classification to stdout
+
+GENESIS_LOG="${GENESIS_LOG:-$HOME/.openclaw/workspace/logs/genesis.log}"
+mkdir -p "$(dirname "$GENESIS_LOG")"
+exec 2> >(tee -a "$GENESIS_LOG" >&2)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RULES="$SCRIPT_DIR/../configs/classification-rules.json"
+source "$SCRIPT_DIR/delivery-target-lib.sh"
+
+score_gt_zero() {
+  local value="${1:-0}"
+  [[ "$(echo "$value > 0" | bc 2>/dev/null || echo 0)" == "1" ]]
+}
+
+if [[ -n "${1:-}" && -f "${1:-}" ]]; then
+  INPUT="$(cat "$1")"
+else
+  INPUT="$(cat)"
+fi
+SESSION_ID="$(echo "$INPUT" | jq -r '.session_id')"
+echo "=== $(date -Iseconds) | classify-idea.sh | session=$SESSION_ID ===" >&2
+RAW_IDEA="$(echo "$INPUT" | jq -r '.raw_idea')"
+METADATA="$(echo "$INPUT" | jq '.metadata // {}')"
+THRESHOLD="$(jq -r '.confidence_threshold' "$RULES")"
+DEFAULT_TYPE="$(jq -r '.default_type' "$RULES")"
+
+echo "Classifying idea for session $SESSION_ID..." >&2
+
+# === Try LLM-based classification first (via openclaw agent --local) ===
+LLM_CLASSIFICATION=""
+if command -v openclaw &>/dev/null; then
+  echo "Trying LLM-based classification..." >&2
+  VALID_TYPES="$(jq -r '.types | keys | join(", ")' "$RULES")"
+  LLM_PROMPT="Classify this software project idea into exactly one type.
+
+Valid types: $VALID_TYPES
+
+Idea: $RAW_IDEA
+
+Return ONLY valid JSON (no markdown fences, no explanation):
+{\"type\": \"<one of: $VALID_TYPES>\", \"confidence\": <0.0-1.0>, \"reasoning\": \"<1 sentence>\"}"
+
+  LLM_RAW="$(timeout 60 openclaw agent --local \
+    -m "$LLM_PROMPT" \
+    --session-id "genesis-classify-${SESSION_ID}" \
+    --json 2>&1)" || echo "[classify-idea] LLM call failed (exit $?)" >&2
+
+  if [[ -n "$LLM_RAW" ]]; then
+    LLM_TEXT="$(echo "$LLM_RAW" | jq -r '.payloads[0].text // empty' 2>/dev/null || true)"
+    LLM_TEXT="$(echo "$LLM_TEXT" | sed '/^```/d; /^json$/d')"
+    # Validate: must have type field with a known type
+    LLM_TYPE="$(echo "$LLM_TEXT" | jq -r '.type // empty' 2>/dev/null || true)"
+    if [[ -n "$LLM_TYPE" ]] && jq -e --arg t "$LLM_TYPE" '.types[$t]' "$RULES" &>/dev/null; then
+      LLM_CLASSIFICATION="$LLM_TEXT"
+      echo "LLM classification: $LLM_TYPE" >&2
+    fi
+  fi
+fi
+
+# === LLM classification succeeded ===
+if [[ -n "$LLM_CLASSIFICATION" ]]; then
+  best_type="$(echo "$LLM_CLASSIFICATION" | jq -r '.type')"
+  confidence="$(echo "$LLM_CLASSIFICATION" | jq -r '.confidence // 0.85')"
+  reasoning="$(echo "$LLM_CLASSIFICATION" | jq -r '.reasoning // "LLM-based classification"')"
+  reasoning="[LLM] $reasoning"
+  alternatives="[]"
+else
+  # === Fallback: keyword/pattern matching ===
+  echo "LLM unavailable, using keyword-based classification..." >&2
+
+  IDEA_LOWER="$(echo "$RAW_IDEA" | tr '[:upper:]' '[:lower:]')"
+
+  best_type="$DEFAULT_TYPE"
+  best_score=0
+  results="[]"
+
+  for type in $(jq -r '.types | keys[]' "$RULES"); do
+    score=0
+    weight="$(jq -r ".types.\"$type\".weight" "$RULES")"
+
+    # Keyword matching
+    while IFS= read -r kw; do
+      if [[ "$IDEA_LOWER" == *"$kw"* ]]; then
+        score=$((score + 1))
+      fi
+    done < <(jq -r ".types.\"$type\".keywords[]" "$RULES")
+
+    # Pattern matching
+    while IFS= read -r pat; do
+      if echo "$RAW_IDEA" | grep -qP "$pat" 2>/dev/null; then
+        score=$((score + 2))
+      fi
+    done < <(jq -r ".types.\"$type\".patterns[]" "$RULES")
+
+    # Apply weight
+    weighted="$(echo "$score * $weight" | bc 2>/dev/null || echo "$score")"
+
+    results="$(echo "$results" | jq --arg t "$type" --argjson s "$score" '. + [{"type": $t, "raw_score": $s}]')"
+
+    if [[ "$(echo "$weighted > $best_score" | bc 2>/dev/null || echo 0)" == "1" ]] || \
+       { [[ "$score" -gt 0 ]] && [[ "$best_score" == "0" ]]; }; then
+      best_score="$weighted"
+      best_type="$type"
+    fi
+  done
+
+  # Calculate confidence
+  if score_gt_zero "$best_score"; then
+    confidence="$(echo "scale=2; $best_score / ($best_score + 2)" | bc 2>/dev/null || echo "0.50")"
+  else
+    confidence="0.30"
+  fi
+
+  # Build alternatives
+  alternatives="$(echo "$results" | jq --arg best "$best_type" '[.[] | select(.type != $best and .raw_score > 0) | {type: .type, confidence: ((.raw_score / (.raw_score + 3)) * 100 | floor / 100)}]')"
+
+  if score_gt_zero "$best_score"; then
+    reasoning="[Keywords] Classified as '$best_type' based on $best_score keyword/pattern matches."
+  else
+    reasoning="[Keywords] No strong signals found. Defaulting to '$DEFAULT_TYPE'."
+  fi
+fi
+
+DELIVERY_TARGET_RAW="$(echo "$INPUT" | jq -r '.metadata.delivery_target // empty')"
+if [[ -z "$DELIVERY_TARGET_RAW" || "$DELIVERY_TARGET_RAW" == "null" ]]; then
+  DELIVERY_TARGET="$(genesis_detect_delivery_target_from_text "$RAW_IDEA")"
+else
+  DELIVERY_TARGET="$(genesis_normalize_delivery_target "$DELIVERY_TARGET_RAW")"
+fi
+
+echo "Result: $best_type (confidence: $confidence)" >&2
+echo "Delivery target: $DELIVERY_TARGET" >&2
+
+jq -n \
+  --arg sid "$SESSION_ID" \
+  --arg idea "$RAW_IDEA" \
+  --arg type "$best_type" \
+  --argjson conf "$confidence" \
+  --argjson alts "$alternatives" \
+  --arg reasoning "$reasoning" \
+  --arg delivery_target "$DELIVERY_TARGET" \
+  --argjson meta "$METADATA" \
+  '{
+    session_id: $sid,
+    step: "classify",
+    raw_idea: $idea,
+    classification: {
+      type: $type,
+      confidence: $conf,
+      alternatives: $alts,
+      reasoning: $reasoning,
+      delivery_target: $delivery_target
+    },
+    metadata: $meta
+  }'