hardness 1.0.0

package/packages/prompts/dist/index.js

@@ -0,0 +1,63 @@
+export const name = '@hardness/prompts';
+/**
+ * Renders a template by substituting the provided variables.
+ */
+export function renderPrompt(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.split(`{${key}}`).join(value || '');
+    }
+    return result;
+}
+export const IMPLEMENTER_TEMPLATE = `
+# AGENT IMPLEMENTATION INSTRUCTIONS
+You are an elite software development agent operating under the **Hardness** orchestrator.
+Your task is to implement the current feature, strictly following the security, quality and constraint rules below.
+
+## Project Information
+- Project: {projectName}
+- Active sprint: Sprint {sprintIndex}
+- Feature: {featureId} - {featureTitle}
+- Feature description: {featureDescription}
+
+## Acceptance Criteria
+{acceptanceCriteria}
+
+## Development Hints
+{hints}
+
+## Related excerpt from SPEC.md
+{specExcerpt}
+
+## Editable Files
+Only the files listed in the feature above may be created or modified:
+{existingFiles}
+
+## Global Rules and Policies
+{rules}
+
+---
+IMPORTANT:
+1. DO NOT modify files that are not listed in the feature above (violation triggers a critical gate failure).
+2. Do not add dependencies not listed without authorization.
+3. Do not use console.log without necessity; prefer a formal logger.
+`;
+export const REVIEWER_TEMPLATE = `
+# CODE REVIEW (REVIEWER)
+Review the code changes made for feature {featureId} - {featureTitle}.
+Ensure that the acceptance criteria have been fully met.
+
+Criteria:
+{acceptanceCriteria}
+
+Check:
+1. Whether formatting rules were maintained.
+2. Whether there are leaked keys or secrets.
+3. Whether unit tests cover the new behavior.
+`;
+export const AUDITOR_TEMPLATE = `
+# FINAL CONSISTENCY AUDIT (AUDITOR)
+Analyze the overall state of project {projectName} after the implementations of sprint {sprintIndex}.
+Ensure the code is clean, that there are no pending circular imports and that the project conventions are consistent.
+`;
+//# sourceMappingURL=index.js.map

package/packages/prompts/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC;AAgBxC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAA4B;IACzE,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCnC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;CAYhC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;CAI/B,CAAC"}

package/packages/prompts/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@hardness/prompts",
+  "version": "1.0.0",
+  "description": "Hardness Prompts — role-based prompt templates for the agent",
+  "author": "cmt-t",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.12.7"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cmt-t/HardNess.git",
+    "directory": "packages/prompts"
+  },
+  "bugs": {
+    "url": "https://github.com/cmt-t/HardNess/issues"
+  },
+  "homepage": "https://github.com/cmt-t/HardNess#readme",
+  "keywords": [
+    "prompts",
+    "templates",
+    "agent",
+    "renderer"
+  ]
+}

package/schemas/config.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "HardnessConfig",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "agent": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "agentCommand": { "type": "string", "description": "Comando invocado para executar o agente. Variáveis: {context_file}, {cwd}, {timeout}." },
+        "thinkingLevel": { "type": "string", "enum": ["none", "low", "medium", "high", "xhigh"] },
+        "timeout": { "type": "number", "minimum": 1, "description": "Timeout em segundos" },
+        "retries": { "type": "number", "minimum": 0 }
+      },
+      "required": ["agentCommand", "thinkingLevel", "timeout", "retries"]
+    },
+    "stack": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "stackProfile": { "type": "string", "enum": ["typescript-node", "generic"] },
+        "typecheckCommand": { "type": "string" },
+        "typecheckTimeout": { "type": "number", "minimum": 1 },
+        "ignoreDirs": { "type": "array", "items": { "type": "string" } },
+        "sourceExtensions": { "type": "array", "items": { "type": "string" } }
+      },
+      "required": ["stackProfile", "typecheckCommand", "typecheckTimeout", "ignoreDirs", "sourceExtensions"]
+    },
+    "security": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "allowedCommandPrefixes": { "type": "array", "items": { "type": "string" } },
+        "blockedPatterns": { "type": "array", "items": { "type": "string" } },
+        "requireTrustedForUnknown": { "type": "boolean" }
+      },
+      "required": ["allowedCommandPrefixes", "blockedPatterns", "requireTrustedForUnknown"]
+    },
+    "logs": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "logDir": { "type": "string" },
+        "redactSecrets": { "type": "boolean" },
+        "redactPatterns": { "type": "array", "items": { "type": "string" } },
+        "retentionDays": { "type": "number", "minimum": 1 }
+      },
+      "required": ["logDir", "redactSecrets", "redactPatterns", "retentionDays"]
+    },
+    "scoring": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "minScore": { "type": "number", "minimum": 0, "maximum": 10 },
+        "blockBelowMin": { "type": "boolean" }
+      },
+      "required": ["minScore", "blockBelowMin"]
+    }
+  },
+  "required": ["agent", "stack", "security", "logs", "scoring"]
+}

package/schemas/context.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "HardnessAgentContext",
+  "type": "object",
+  "properties": {
+    "sprint": {
+      "type": "object",
+      "properties": {
+        "index": { "type": "integer" },
+        "name": { "type": "string" }
+      },
+      "required": ["index", "name"]
+    },
+    "feature": {
+      "type": "object",
+      "properties": {
+        "id": { "type": "string" },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "specLines": { "type": "string" },
+        "status": { "type": "string" },
+        "files": { "type": "array" },
+        "acceptanceCriteria": { "type": "array" },
+        "hints": { "type": "array" }
+      },
+      "required": ["id", "title", "description", "status", "files", "acceptanceCriteria", "hints"]
+    },
+    "specExcerpt": { "type": "string" },
+    "rulesExcerpt": { "type": "string" },
+    "existingFiles": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    }
+  },
+  "required": ["sprint", "feature", "specExcerpt", "rulesExcerpt", "existingFiles"]
+}

package/schemas/index.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "HardnessSprintIndex",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "projectName": { "type": "string", "minLength": 1 },
+    "specPath": { "type": "string", "description": "Caminho (relativo à raiz) para SPEC.md" },
+    "totalSprints": { "type": "number", "minimum": 0 },
+    "schemaVersion": { "type": "number" },
+    "description": { "type": "string" },
+    "sprints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "index": { "type": "number", "minimum": 0 },
+          "file": { "type": "string", "pattern": "^\\d{2}-[a-z0-9-]+\\.json$" },
+          "name": { "type": "string", "minLength": 1 },
+          "status": { "type": "string", "enum": ["pending", "in-progress", "done"] },
+          "featuresCount": { "type": "number", "minimum": 0 }
+        },
+        "required": ["index", "file", "name", "status", "featuresCount"]
+      }
+    }
+  },
+  "required": ["projectName", "specPath", "totalSprints", "schemaVersion", "description", "sprints"]
+}

package/schemas/sprint.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "HardnessSprint",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "index": { "type": "number", "minimum": 0, "description": "Índice da sprint (0-based)" },
+    "name": { "type": "string", "minLength": 1, "description": "Nome legível da sprint" },
+    "status": { "type": "string", "enum": ["pending", "in-progress", "done"] },
+    "description": { "type": "string" },
+    "crossCutting": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Regras que valem para todas as features desta sprint"
+    },
+    "features": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/feature" }
+    }
+  },
+  "required": ["index", "name", "status", "description", "features"],
+  "definitions": {
+    "feature": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "pattern": "^feat-\\d{3}[a-z]?$", "description": "Identificador único na sprint (ex: feat-001)" },
+        "title": { "type": "string", "minLength": 1 },
+        "description": { "type": "string" },
+        "specLines": { "type": "string", "description": "Intervalo de linhas na SPEC.md (ex: \"10-25\" ou \"1,3,5-7\")" },
+        "status": { "type": "string", "enum": ["pending", "in-progress", "done"] },
+        "startedAt": { "type": "string" },
+        "completedAt": { "type": "string" },
+        "files": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              { "type": "string", "description": "Caminho relativo do arquivo" },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "file": { "type": "string" },
+                  "lines": { "type": "string", "description": "Intervalo de linhas ou \"new\" para arquivo novo" }
+                },
+                "required": ["file", "lines"]
+              }
+            ]
+          }
+        },
+        "acceptanceCriteria": { "type": "array", "items": { "type": "string" } },
+        "hints": { "type": "array", "items": { "type": "string" } },
+        "verification": { "$ref": "#/definitions/verification" }
+      },
+      "required": ["id", "title", "description", "specLines", "status", "files", "acceptanceCriteria", "hints", "verification"]
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "typecheck": { "type": "boolean" },
+        "typecheckCommand": { "type": "string" },
+        "parseable": { "type": "boolean", "description": "Exige que os arquivos sejam parseáveis (sintaxe válida)" },
+        "grepMustMatch": { "type": "array", "items": { "type": "string" } },
+        "grepMustNotMatch": { "type": "array", "items": { "type": "string" } },
+        "grepFiles": { "type": "array", "items": { "type": "string" } },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "name": { "type": "string" },
+              "manifest": { "type": "string" }
+            },
+            "required": ["name"]
+          }
+        },
+        "smoke": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "command": { "type": "string" },
+            "executedBy": { "type": "string", "enum": ["workflow", "agent"] },
+            "timeoutSeconds": { "type": "number", "minimum": 1 }
+          },
+          "required": ["command", "executedBy"]
+        },
+        "auditCategory": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "category": { "type": "string" },
+            "failOnSeverityAtOrAbove": { "type": "string", "enum": ["LOW", "MED", "HIGH", "NONE"] }
+          },
+          "required": ["category", "failOnSeverityAtOrAbove"]
+        },
+        "auditFinal": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "failOnSeverityAtOrAbove": { "type": "string", "enum": ["LOW", "MED", "HIGH", "NONE"] }
+          },
+          "required": ["failOnSeverityAtOrAbove"]
+        }
+      }
+    }
+  }
+}

package/templates/PRD-TEMPLATE.md

@@ -0,0 +1,36 @@
+# PRD — <Project Name>
+
+> Product Requirements Document. Generated by `hardness discover` or written manually.
+> This template is the input for `hardness spec`.
+
+## 1. Overview
+
+Describe in 1-2 paragraphs what the product is, who it is for, and what problem it solves.
+
+## 2. Personas
+
+| Persona | Description | Needs |
+|---|---|---|
+| <persona 1> | <description> | <needs> |
+
+## 3. Functional Requirements
+
+- **FR-001**: <requirement description>
+- **FR-002**: <requirement description>
+
+## 4. Non-Functional Requirements
+
+- **NFR-001**: <description> (e.g. performance, security, observability)
+
+## 5. Out of Scope (v1.0)
+
+- <explicitly excluded item>
+
+## 6. Product Acceptance Criteria
+
+- [ ] <measurable acceptance criterion>
+
+## 7. Assumptions and Risks
+
+- **Assumptions**: <assumption>
+- **Risks**: <risk> — <mitigation>

package/templates/SPEC-TEMPLATE.md

@@ -0,0 +1,59 @@
+# SPEC — <Project Name>
+
+> Technical specification. Generated by `hardness spec` from PRD.md, or written manually.
+> This template is the input for `hardness plan`. The `specLines` in each feature reference lines from this file.
+
+## 1. Architectural Vision
+
+Describe the target architecture: component diagram, layers, data flow.
+
+```
+<ascii/mermaid diagram>
+```
+
+## 2. Tech Stack
+
+- **Language**: <e.g. TypeScript 5.4 / Node 20>
+- **Framework**: <e.g. Fastify / Express / none>
+- **Tests**: <e.g. Vitest>
+- **Database**: <e.g. none / SQLite>
+- **Others**: <e.g. Zod, picocolors>
+
+## 3. Modules / Packages
+
+| Module | Responsibility |
+|---|---|
+| <module 1> | <responsibility> |
+
+## 4. Data Model
+
+<description of entities, schema, configuration file format>
+
+## 5. Main Flows
+
+### 5.1 <Flow 1>
+1. <step>
+2. <step>
+
+## 6. Integration Contracts
+
+- **CLI**: <commands and flags>
+- **Config**: <path and format>
+
+## 7. Detailed Technical Requirements
+
+(The lines below will be referenced by `specLines` in the sprints.)
+
+1. <technical requirement 1>
+2. <technical requirement 2>
+3. <technical requirement 3>
+4. <technical requirement 4>
+5. <technical requirement 5>
+6. <technical requirement 6>
+7. <technical requirement 7>
+8. <technical requirement 8>
+9. <technical requirement 9>
+10. <technical requirement 10>
+
+> Keep numbering as needed. The `specLines` in features reference
+> these numbers (e.g. `"specLines": "10-25"`).

package/templates/SPRINT-TEMPLATE.json

@@ -0,0 +1,62 @@
+{
+  "index": 0,
+  "name": "Sprint 00 — Bootstrap",
+  "status": "pending",
+  "description": "Project foundation: monorepo setup, build, tests and first commands.",
+  "crossCutting": [
+    "Do not add dependencies without review",
+    "All new code must have tests"
+  ],
+  "features": [
+    {
+      "id": "feat-001",
+      "title": "Initialize monorepo",
+      "description": "Create root package.json, tsconfig and packages structure.",
+      "specLines": "1-5",
+      "status": "pending",
+      "files": [
+        "package.json",
+        "tsconfig.base.json"
+      ],
+      "acceptanceCriteria": [
+        "npm install runs without errors",
+        "npm run build compiles all packages"
+      ],
+      "hints": [
+        "Use npm workspaces",
+        "Configure strict mode in tsconfig"
+      ],
+      "verification": {
+        "typecheck": true,
+        "parseable": true,
+        "grepMustMatch": [],
+        "grepMustNotMatch": [],
+        "grepFiles": []
+      }
+    },
+    {
+      "id": "feat-002",
+      "title": "Configure tests",
+      "description": "Install vitest and create a smoke test.",
+      "specLines": "6-8",
+      "status": "pending",
+      "files": [
+        { "file": "vitest.workspace.ts", "lines": "new" }
+      ],
+      "acceptanceCriteria": [
+        "npm test runs and passes"
+      ],
+      "hints": [
+        "Create a smoke test in each package"
+      ],
+      "verification": {
+        "typecheck": true,
+        "smoke": {
+          "command": "npm test",
+          "executedBy": "workflow",
+          "timeoutSeconds": 60
+        }
+      }
+    }
+  ]
+}

package/templates/config.example.json

@@ -0,0 +1,30 @@
+{
+  "agent": {
+    "agentCommand": "echo \"[hardness] Configure agentCommand aqui. Use getPresetConfig('claude-code' | 'codex' | 'manual') para presets. Contexto em: {context_file}\"",
+    "thinkingLevel": "high",
+    "timeout": 2400,
+    "retries": 4
+  },
+  "stack": {
+    "stackProfile": "typescript-node",
+    "typecheckCommand": "npm run typecheck",
+    "typecheckTimeout": 180,
+    "ignoreDirs": ["node_modules", "dist", ".git", ".hardness"],
+    "sourceExtensions": [".ts", ".tsx", ".js", ".jsx", ".json", ".yaml", ".toml"]
+  },
+  "security": {
+    "allowedCommandPrefixes": ["grep", "cat", "node", "npm", "npx", "tsc", "python"],
+    "blockedPatterns": ["rm\\s+-rf", "curl.*\\|.*sh", "wget.*\\|.*sh", "sudo\\s+"],
+    "requireTrustedForUnknown": true
+  },
+  "logs": {
+    "logDir": ".hardness/logs",
+    "redactSecrets": true,
+    "redactPatterns": ["(?i)(api[_-]?key|token|secret|password|auth)\\s*[:=]\\s*\\S+"],
+    "retentionDays": 30
+  },
+  "scoring": {
+    "minScore": 6.0,
+    "blockBelowMin": true
+  }
+}