@harness-forge/cli 0.1.0

package/schemas/runtime/file-interest.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/file-interest.schema.json",
+  "title": "Task-aware file interest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["taskId", "generatedAt", "items"],
+  "properties": {
+    "taskId": { "type": "string" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "basedOnCommit": { "type": "string" },
+    "items": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/fileInterestItem" }
+    }
+  },
+  "$defs": {
+    "bucket": {
+      "type": "string",
+      "enum": ["must-include", "strongly-relevant", "supporting-context", "ignore-for-now"]
+    },
+    "confidenceLevel": {
+      "type": "string",
+      "enum": ["low", "medium", "high"]
+    },
+    "reviewStatus": {
+      "type": "string",
+      "enum": ["draft", "inferred", "confirmed", "approved", "stale", "superseded"]
+    },
+    "fileInterestItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "role",
+        "score",
+        "bucket",
+        "reasons",
+        "confidence",
+        "reviewStatus"
+      ],
+      "properties": {
+        "path": { "type": "string" },
+        "role": { "type": "string" },
+        "module": { "type": "string" },
+        "score": { "type": "number" },
+        "bucket": { "$ref": "#/$defs/bucket" },
+        "matchedKeywords": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "riskTags": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "relatedTests": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "relatedAdrs": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "evidence": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "confidence": { "$ref": "#/$defs/confidenceLevel" },
+        "reviewStatus": { "$ref": "#/$defs/reviewStatus" },
+        "lastAnalyzedCommit": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/runtime/flow-state.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/flow-state.schema.json",
+  "title": "Harness Forge Flow State",
+  "type": "object",
+  "required": [
+    "featureId",
+    "currentStage",
+    "status",
+    "lastArtifact",
+    "nextAction",
+    "updatedAt"
+  ],
+  "properties": {
+    "featureId": { "type": "string", "minLength": 1 },
+    "currentStage": {
+      "type": "string",
+      "enum": ["clarify", "specify", "plan", "analyze", "tasks", "implement", "validate"]
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "blocked", "paused", "complete"]
+    },
+    "lastArtifact": { "type": "string", "minLength": 1 },
+    "nextAction": { "type": "string", "minLength": 1 },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "artifactLineage": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "notes": { "type": "string" },
+    "targetContext": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/schemas/runtime/impact-analysis.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/impact-analysis.schema.json",
+  "title": "Task impact analysis",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["taskId", "generatedAt", "affectedModules", "riskAreas", "suggestedTests"],
+  "properties": {
+    "taskId": { "type": "string" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "basedOnCommit": { "type": "string" },
+    "architectureSignificance": { "$ref": "#/$defs/architectureSignificanceAssessment" },
+    "affectedModules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "reason", "confidence"],
+        "properties": {
+          "id": { "type": "string" },
+          "paths": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "reason": { "type": "string" },
+          "confidence": {
+            "type": "string",
+            "enum": ["low", "medium", "high"]
+          }
+        }
+      }
+    },
+    "riskAreas": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "suggestedTests": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "relatedAdrs": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "openQuestions": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "architectureSignificanceAssessment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskId", "level", "signals", "confidence", "reviewStatus", "assessedAt", "assessedBy"],
+      "properties": {
+        "taskId": { "type": "string" },
+        "level": {
+          "type": "string",
+          "enum": ["low", "medium", "high", "critical"]
+        },
+        "signals": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        },
+        "sourceRefs": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "confidence": {
+          "type": "string",
+          "enum": ["low", "medium", "high"]
+        },
+        "reviewStatus": {
+          "type": "string",
+          "enum": ["draft", "inferred", "confirmed", "approved", "stale", "superseded"]
+        },
+        "assessedAt": { "type": "string", "format": "date-time" },
+        "assessedBy": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/runtime/instruction-plan.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/instruction-plan.schema.json",
+  "title": "Instruction plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "workspaceId",
+    "targetId",
+    "scopeStrategy",
+    "recommendations",
+    "recommendedProfiles",
+    "recommendedSkills",
+    "generatedArtifacts",
+    "riskNotes"
+  ],
+  "properties": {
+    "workspaceId": { "type": "string" },
+    "targetId": { "type": "string" },
+    "scopeStrategy": {
+      "type": "string",
+      "enum": ["root-only", "mixed-scope", "scoped-heavy"]
+    },
+    "recommendations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "surfaceType", "reason", "confidence", "evidence", "writeMode"],
+        "properties": {
+          "path": { "type": "string" },
+          "surfaceType": { "type": "string" },
+          "reason": { "type": "string" },
+          "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+          "evidence": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "writeMode": {
+            "type": "string",
+            "enum": ["recommend-only", "diff", "write"]
+          }
+        }
+      }
+    },
+    "recommendedProfiles": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "recommendedSkills": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "generatedArtifacts": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "riskNotes": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/runtime/observability-event.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/observability-event.schema.json",
+  "title": "Observability event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "eventType",
+    "recordedAt",
+    "workspaceId",
+    "target",
+    "result"
+  ],
+  "properties": {
+    "eventId": { "type": "string" },
+    "eventType": { "type": "string" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "workspaceId": { "type": "string" },
+    "target": { "type": "string" },
+    "featureId": { "type": "string" },
+    "result": { "type": "string" },
+    "durationMs": { "type": "number", "minimum": 0 },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "inputs": { "type": "object" },
+    "outputs": { "type": "object" },
+    "artifacts": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "evidence": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/runtime/observability-summary.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/observability-summary.schema.json",
+  "title": "Observability summary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "generatedAt",
+    "totalEvents",
+    "byEventType",
+    "byResult",
+    "driftFindings"
+  ],
+  "properties": {
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "totalEvents": { "type": "integer", "minimum": 0 },
+    "byEventType": {
+      "type": "object",
+      "additionalProperties": { "type": "integer", "minimum": 0 }
+    },
+    "byResult": {
+      "type": "object",
+      "additionalProperties": { "type": "integer", "minimum": 0 }
+    },
+    "recommendationAcceptanceRate": { "type": "number", "minimum": 0, "maximum": 1 },
+    "benchmarkPassRate": { "type": "number", "minimum": 0, "maximum": 1 },
+    "driftFindings": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/schemas/runtime/recursive-adr-candidate.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/recursive-adr-candidate.schema.json",
+  "title": "Recursive ADR candidate",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "candidateId",
+    "taskId",
+    "linkedAsrRefs",
+    "title",
+    "context",
+    "decision",
+    "alternatives",
+    "tradeoffs",
+    "evidenceRefs",
+    "consequences",
+    "openQuestions",
+    "promotionRecommendation"
+  ],
+  "properties": {
+    "candidateId": { "type": "string" },
+    "taskId": { "type": "string" },
+    "linkedAsrRefs": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "title": { "type": "string" },
+    "context": { "type": "string" },
+    "decision": { "type": "string" },
+    "alternatives": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "tradeoffs": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "consequences": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "openQuestions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "promotionRecommendation": {
+      "type": "string",
+      "enum": ["promote", "revise", "hold"]
+    }
+  }
+}

package/schemas/runtime/recursive-budget.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/recursive-budget.schema.json",
+  "title": "Recursive budget policy",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "policyId",
+    "maxDepth",
+    "maxIterations",
+    "maxSubcalls",
+    "maxBatchWidth",
+    "maxDurationMs",
+    "maxToolReads",
+    "allowWritesToScratchOnly",
+    "allowNetwork",
+    "sandboxMode",
+    "isolationLevel"
+  ],
+  "properties": {
+    "policyId": { "type": "string" },
+    "maxDepth": { "type": "integer", "minimum": 0 },
+    "maxIterations": { "type": "integer", "minimum": 1 },
+    "maxSubcalls": { "type": "integer", "minimum": 0 },
+    "maxBatchWidth": { "type": "integer", "minimum": 1 },
+    "maxDurationMs": { "type": "integer", "minimum": 1 },
+    "maxTokensApprox": { "type": "integer", "minimum": 1 },
+    "maxToolReads": { "type": "integer", "minimum": 1 },
+    "allowWritesToScratchOnly": { "type": "boolean" },
+    "allowNetwork": { "type": "boolean" },
+    "sandboxMode": {
+      "type": "string",
+      "enum": ["disabled", "restricted", "isolated"]
+    },
+    "isolationLevel": {
+      "type": "string",
+      "enum": ["metadata-only", "read-only-inspection", "read-only-repl", "isolated-execution"]
+    }
+  }
+}

package/schemas/runtime/recursive-session-summary.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/recursive-session-summary.schema.json",
+  "title": "Recursive session summary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "sessionId",
+    "outcome",
+    "summary",
+    "promotedArtifacts",
+    "outstandingGaps",
+    "budgetReport",
+    "followUp",
+    "generatedAt"
+  ],
+  "properties": {
+    "sessionId": { "type": "string" },
+    "taskId": { "type": "string" },
+    "outcome": {
+      "type": "string",
+      "enum": ["completed", "partial", "blocked", "failed", "draft"]
+    },
+    "summary": { "type": "string" },
+    "promotedArtifacts": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "outstandingGaps": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "budgetReport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policyId", "limitsHit"],
+      "properties": {
+        "policyId": { "type": "string" },
+        "limitsHit": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "notes": { "type": "string" }
+      }
+    },
+    "followUp": { "type": "string" },
+    "generatedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/runtime/recursive-session.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/recursive-session.schema.json",
+  "title": "Recursive session",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "sessionId",
+    "status",
+    "createdAt",
+    "updatedAt",
+    "budgetPolicy",
+    "handles",
+    "tools",
+    "promotionState"
+  ],
+  "properties": {
+    "sessionId": { "type": "string" },
+    "taskId": { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "running", "paused", "finalized", "failed"]
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "rootObjective": { "type": "string" },
+    "budgetPolicy": { "$ref": "recursive-budget.schema.json" },
+    "handles": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/artifactHandle" }
+    },
+    "tools": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "compactedSummary": { "type": "string" },
+    "parentSessionId": { "type": "string" },
+    "promotionState": {
+      "type": "string",
+      "enum": ["draft-only", "partially-promoted", "fully-promoted"]
+    }
+  },
+  "$defs": {
+    "artifactHandle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["handleId", "handleType", "targetRef", "label", "summary", "stalenessState"],
+      "properties": {
+        "handleId": { "type": "string" },
+        "handleType": {
+          "type": "string",
+          "enum": ["repo-file", "repo-slice", "task-artifact", "decision-artifact", "template", "summary", "search-result"]
+        },
+        "targetRef": { "type": "string" },
+        "label": { "type": "string" },
+        "summary": { "type": "string" },
+        "stalenessState": {
+          "type": "string",
+          "enum": ["fresh", "unknown", "stale"]
+        },
+        "sourceArtifactType": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/runtime/recursive-trace-event.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/recursive-trace-event.schema.json",
+  "title": "Recursive trace event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["eventId", "sessionId", "eventType", "occurredAt", "actor", "status"],
+  "properties": {
+    "eventId": { "type": "string" },
+    "sessionId": { "type": "string" },
+    "eventType": {
+      "type": "string",
+      "enum": ["tool-call", "batch-start", "batch-end", "subcall", "promotion", "budget-breach", "compact", "finalize", "resume"]
+    },
+    "occurredAt": { "type": "string", "format": "date-time" },
+    "actor": {
+      "type": "string",
+      "enum": ["runtime", "operator", "child-session"]
+    },
+    "inputRefs": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "outputRefs": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "status": {
+      "type": "string",
+      "enum": ["success", "partial", "blocked", "failed"]
+    },
+    "budgetImpact": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "iterationsUsed": { "type": "integer", "minimum": 0 },
+        "subcallsUsed": { "type": "integer", "minimum": 0 },
+        "batchWidthUsed": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "notes": { "type": "string" }
+  }
+}

package/schemas/runtime/repo-map.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harness-forge.dev/schemas/runtime/repo-map.schema.json",
+  "title": "Repo map",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "workspaceId",
+    "workspaceType",
+    "dominantLanguages",
+    "frameworks",
+    "services",
+    "criticalPaths",
+    "highRiskPaths",
+    "existingInstructionSurfaces",
+    "qualityGaps",
+    "supportingEvidence"
+  ],
+  "properties": {
+    "workspaceId": { "type": "string" },
+    "workspaceType": { "type": "string" },
+    "dominantLanguages": { "$ref": "#/$defs/repoFacts" },
+    "frameworks": { "$ref": "#/$defs/repoFacts" },
+    "services": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "path", "classification"],
+        "properties": {
+          "id": { "type": "string" },
+          "path": { "type": "string" },
+          "classification": { "type": "string" }
+        }
+      }
+    },
+    "criticalPaths": { "$ref": "#/$defs/stringArray" },
+    "highRiskPaths": { "$ref": "#/$defs/stringArray" },
+    "existingInstructionSurfaces": { "$ref": "#/$defs/stringArray" },
+    "qualityGaps": { "$ref": "#/$defs/repoFacts" },
+    "supportingEvidence": { "$ref": "#/$defs/stringArray" }
+  },
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "repoFacts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "confidence", "evidence"],
+        "properties": {
+          "id": { "type": "string" },
+          "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+          "evidence": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}