@entelligentsia/forgecli 0.19.0 → 0.20.3

package/dist/forge-payload/schemas/project-context.schema.json

@@ -0,0 +1,167 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "project-context.schema.json",
+  "title": "Project Context",
+  "description": "Machine-readable bridge file produced by the Discover phase (Phase 2) of the Forge init flow. Governs project-context.json written by the Phase 2 Discover agent and read by the T03 substitution tool. Distinct from project-overlay.schema.json, which is a per-spawn runtime context overlay; this schema captures persistent project metadata discovered at init/migrate time.",
+  "type": "object",
+  "required": ["project"],
+  "additionalProperties": false,
+  "properties": {
+    "project": {
+      "type": "object",
+      "required": ["name", "prefix"],
+      "additionalProperties": false,
+      "properties": {
+        "name":        { "type": "string", "description": "Human-readable project name" },
+        "prefix":      { "type": "string", "description": "Short identifier prefix (e.g. MYAPP)" },
+        "description": { "type": "string", "description": "Brief project description", "default": "" },
+        "stack": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Technology stack in display order (e.g. [\"Express 4.22\", \"MongoDB 7\"])",
+          "default": []
+        },
+        "commands": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Primary project lifecycle commands",
+          "properties": {
+            "test":   { "type": "string", "default": "" },
+            "build":  { "type": "string", "default": "" },
+            "deploy": { "type": "string", "default": "" }
+          }
+        }
+      }
+    },
+    "architecture": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "frameworks": {
+          "type": "object",
+          "additionalProperties": false,
+          "x-placeholder": "STACK_SUMMARY",
+          "description": "Primary frameworks by tier. Rendered as 'backend + frontend + database' string by T03 substitution tool.",
+          "properties": {
+            "backend":  { "type": "string", "default": "" },
+            "frontend": { "type": "string", "default": "" },
+            "database": { "type": "string", "default": "" }
+          }
+        },
+        "dataAccess": {
+          "type": "string",
+          "description": "Data access pattern (e.g. 'Mongoose ODM')",
+          "default": ""
+        },
+        "deployment": {
+          "type": "string",
+          "description": "Deployment target summary (e.g. 'AWS ECS')",
+          "default": ""
+        },
+        "keyDirectories": {
+          "type": "array",
+          "items": { "type": "string" },
+          "x-placeholder": "KEY_DIRECTORIES",
+          "description": "Key source directories joined to 'routes/, admin-app/, ...' by T03.",
+          "default": []
+        }
+      }
+    },
+    "entities": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Domain entity names (e.g. [\"User\", \"Order\", \"Product\"])",
+      "default": []
+    },
+    "conventions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "branching": {
+          "type": "string",
+          "x-placeholder": "BRANCHING_CONVENTION",
+          "description": "Branching strategy description (e.g. 'feature/TASK-ID-slug'). Direct string substitution by T03.",
+          "default": ""
+        },
+        "taskIdFormat": {
+          "type": "string",
+          "description": "Task ID format pattern (e.g. 'PROJ-###')",
+          "default": ""
+        }
+      }
+    },
+    "impactCategories": {
+      "type": "array",
+      "items": { "type": "string" },
+      "x-placeholder": "IMPACT_CATEGORIES",
+      "description": "Impact/risk category labels joined to comma-separated string by T03.",
+      "default": []
+    },
+    "technicalDebt": {
+      "type": "array",
+      "items": { "type": "string" },
+      "x-placeholder": "TECHNICAL_DEBT",
+      "description": "Known technical debt items joined to comma-separated string by T03.",
+      "default": []
+    },
+    "deployment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "environments": {
+          "type": "array",
+          "x-placeholder": "DEPLOYMENT_ENVIRONMENTS",
+          "description": "Deployment environment definitions rendered as a markdown table by T03.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "name":     { "type": "string", "default": "" },
+              "frontend": { "type": "string", "default": "" },
+              "backend":  { "type": "string", "default": "" },
+              "region":   { "type": "string", "default": "" }
+            }
+          },
+          "default": []
+        },
+        "impactNotes": {
+          "type": "string",
+          "description": "Freeform deployment impact notes",
+          "default": ""
+        }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "x-placeholder": "VERIFICATION_COMMANDS",
+      "additionalProperties": false,
+      "description": "Full verification command suite. Rendered as 'npm run type-check, npm test, npm run build' by T03.",
+      "properties": {
+        "typeCheck":   { "type": "string", "default": "" },
+        "lint":        { "type": "string", "default": "" },
+        "test":        { "type": "string", "default": "" },
+        "build":       { "type": "string", "default": "" },
+        "infraBuild":  { "type": "string", "default": "" }
+      }
+    },
+    "skillWiring": {
+      "type": "array",
+      "x-placeholder": "SKILL_DIRECTIVES",
+      "description": "Skill-to-persona wiring. Rendered as 'skill → persona1, persona2' lines by T03. Mirrors config.json skillWiring so T03 has a single source.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["skill"],
+        "properties": {
+          "skill":    { "type": "string" },
+          "personas": {
+            "type": "array",
+            "items": { "type": "string" },
+            "default": []
+          }
+        }
+      },
+      "default": []
+    }
+  }
+}

package/dist/forge-payload/schemas/project-overlay.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "project-overlay.schema.json",
+  "title": "Project Overlay",
+  "description": "Per-spawn context overlay materialized by the orchestrator. Budget: ≤1kB JSON.",
+  "version": "1.0.0",
+  "type": "object",
+  "required": ["projectPrefix", "storeRoot", "indexSlice"],
+  "additionalProperties": false,
+  "properties": {
+    "version":          { "type": "string", "description": "Schema version string. Read by manage-versions.cjs to populate overlayToolVersion at init time.", "default": "1.0.0" },
+    "projectPrefix":    { "type": "string", "pattern": "^[A-Z][A-Z0-9-]+$" },
+    "sprintId":         { "type": "string" },
+    "sprintDir":        { "type": "string" },
+    "taskId":           { "type": "string" },
+    "taskDir":          { "type": "string" },
+    "taskStatus":       { "type": "string" },
+    "bugId":            { "type": "string" },
+    "bugDir":           { "type": "string" },
+    "storeRoot":        { "type": "string" },
+    "indexSlice":       { "type": "string", "maxLength": 800 },
+    "toolCommands":     { "type": "object" },
+    "lastPhaseSummary": { "type": "object" }
+  }
+}

package/dist/forge-payload/schemas/proposal.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/proposal.schema.json",
+  "title": "EnhancementProposal",
+  "description": "A single Phase 2 enrichment proposal emitted by /forge:enhance. Each record carries an op classification (insert/update/delete a skill artifact), the target file path, and a diff body. Foundation for the T03 judge, T05 delete detection, T06 compression gate, and T07 queue drain.",
+  "type": "object",
+  "required": ["op", "target_path", "diff_body"],
+  "properties": {
+    "proposalId":         { "type": "string", "minLength": 1 },
+    "op": {
+      "type": "string",
+      "enum": ["insert_skill", "update_skill", "delete_skill"],
+      "description": "Three-op classification: insert a new skill artifact, update an existing one, or delete an existing one."
+    },
+    "target_path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Repository-relative path to the artifact being inserted, updated, or deleted (e.g. forge/skills/engineer-skills.md)."
+    },
+    "diff_body": {
+      "type": "string",
+      "description": "Unified-diff body or full file body for inserts. For delete_skill this may be empty — the op + target_path is sufficient."
+    },
+    "rationale":          { "type": "string" },
+    "sourceFrictionIds":  { "type": "array", "items": { "type": "string" } },
+    "generated_at":       { "type": "string", "format": "date-time" },
+    "sprintId":           { "type": "string" },
+    "recurrence_count": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "FORGE-S24-T04 — count of distinct tasks within the same sprint that emitted a matching (subkind, evidence.skillId) friction event, including the originating task. Always >= 1."
+    },
+    "recurrence_task_ids": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "FORGE-S24-T04 — taskOrder-sorted list of task IDs that contributed to recurrence_count. Empty when the originating friction event cannot be resolved from sourceFrictionIds."
+    }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/schemas/sprint.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/sprint.schema.json",
+  "title": "Sprint",
+  "type": "object",
+  "required": ["sprintId", "title", "status", "taskIds", "createdAt"],
+  "properties": {
+    "sprintId":       { "type": "string" },
+    "feature_id":     { "type": ["string", "null"] },
+    "title":          { "type": "string" },
+    "description":    { "type": "string" },
+    "goal":            { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": ["planning", "active", "completed", "retrospective-done", "blocked", "partially-completed", "abandoned"]
+    },
+    "taskIds":        { "type": "array", "items": { "type": "string" } },
+    "dependencies":   { "type": "object" },
+    "executionMode":  { "type": "string", "enum": ["sequential", "wave-parallel", "full-parallel"] },
+    "createdAt":      { "type": "string", "format": "date-time" },
+    "completedAt":    { "type": "string", "format": "date-time" },
+    "path":           { "type": "string" },
+    "humanEstimates": { "type": "object" },
+    "features":       { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/schemas/structure-versions.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "structure-versions.schema.json",
+  "title": "Structure Versions",
+  "description": "Tracks versioned structural snapshots of .forge/ elements. Lives at .forge/structure-versions.json (NOT under .forge/store/). Composition model: Working Artifact = base@pluginVersion + snapshot@currentSnapshot + user_enhancements. Snapshot-array invariant: snapshots is ordered ascending by index; currentSnapshot always equals snapshots[snapshots.length - 1].index. Idempotency: manage-versions.cjs init is a no-op if the file already exists.",
+  "type": "object",
+  "required": ["basePackVersion", "overlayToolVersion", "currentSnapshot", "snapshots"],
+  "additionalProperties": false,
+  "properties": {
+    "basePackVersion": {
+      "type": "string",
+      "description": "Plugin version at materialization time. Ties the snapshot set to a specific base-pack release."
+    },
+    "overlayToolVersion": {
+      "type": "string",
+      "description": "Version of project-overlay.schema.json at materialization time. Independent of structural drift; lets /forge:update detect runtime-contract drift."
+    },
+    "currentSnapshot": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Index of the snapshot that produced the current .forge/ working set. Always equals snapshots[snapshots.length - 1].index."
+    },
+    "snapshots": {
+      "type": "array",
+      "description": "Ordered list of snapshots, ascending by index. Index 0 is always the base-pack snapshot.",
+      "items": {
+        "type": "object",
+        "required": ["index", "createdAt", "source"],
+        "additionalProperties": false,
+        "properties": {
+          "index": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "source": {
+            "type": "string",
+            "description": "Origin of the snapshot: 'base-pack', 'post-init', 'post-sprint:SPRINT_ID', 'manual'"
+          },
+          "enhancedElements": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Relative paths of .forge/ elements modified in this snapshot. Empty for snapshot 0.",
+            "default": []
+          },
+          "archivePath": {
+            "type": ["string", "null"],
+            "description": "Path to the archive directory for this snapshot, e.g. .forge/archive/snap-1/. Null for snapshot 0 (nothing to archive before first enhancement)."
+          }
+        }
+      }
+    }
+  }
+}

package/dist/forge-payload/schemas/task.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/task.schema.json",
+  "title": "Task",
+  "type": "object",
+  "required": ["taskId", "sprintId", "title", "status", "path"],
+  "properties": {
+    "taskId":               { "type": "string" },
+    "feature_id":           { "type": ["string", "null"] },
+    "sprintId":             { "type": "string" },
+    "title":                { "type": "string" },
+    "description":          { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft", "planned", "plan-approved", "implementing",
+        "implemented", "review-approved", "approved", "committed",
+        "plan-revision-required", "code-revision-required", "blocked", "escalated", "abandoned"
+      ]
+    },
+    "path":                 { "type": "string" },
+    "estimate":             { "type": "string", "enum": ["S", "M", "L", "XL"] },
+    "dependencies":         { "type": "array", "items": { "type": "string" } },
+    "knowledgeUpdates":     { "type": "array" },
+    "planIterations":       { "type": "integer", "minimum": 0 },
+    "codeReviewIterations": { "type": "integer", "minimum": 0 },
+    "assignedModel":        { "type": "string" },
+    "pipeline":             { "type": "string" },
+    "summaries": {
+      "type": "object",
+      "description": "Terse structured summaries of phase artifacts. Optional; full artifacts on disk remain authoritative.",
+      "properties": {
+        "plan":           { "$ref": "_defs/phaseSummary.schema.json" },
+        "review_plan":    { "$ref": "_defs/phaseSummary.schema.json" },
+        "implementation": { "$ref": "_defs/phaseSummary.schema.json" },
+        "code_review":    { "$ref": "_defs/phaseSummary.schema.json" },
+        "validation":     { "$ref": "_defs/phaseSummary.schema.json" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/schemas/transitions/bug.json

@@ -0,0 +1,31 @@
+[
+  {
+    "from": "reported",
+    "to": [
+      "triaged",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "triaged",
+    "to": [
+      "in-progress",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "in-progress",
+    "to": [
+      "fixed",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "fixed",
+    "to": []
+  },
+  {
+    "from": "abandoned",
+    "to": []
+  }
+]

package/dist/forge-payload/schemas/transitions/sprint.json

@@ -0,0 +1,46 @@
+[
+  {
+    "from": "planning",
+    "to": [
+      "active",
+      "blocked",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "active",
+    "to": [
+      "completed",
+      "partially-completed",
+      "blocked",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "completed",
+    "to": [
+      "retrospective-done"
+    ]
+  },
+  {
+    "from": "partially-completed",
+    "to": [
+      "retrospective-done"
+    ]
+  },
+  {
+    "from": "retrospective-done",
+    "to": []
+  },
+  {
+    "from": "blocked",
+    "to": [
+      "active",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "abandoned",
+    "to": []
+  }
+]

package/dist/forge-payload/schemas/transitions/task.json

@@ -0,0 +1,109 @@
+[
+  {
+    "from": "draft",
+    "to": [
+      "planned",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "planned",
+    "to": [
+      "plan-approved",
+      "plan-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "plan-approved",
+    "to": [
+      "implementing",
+      "plan-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "implementing",
+    "to": [
+      "implemented",
+      "plan-revision-required",
+      "code-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "implemented",
+    "to": [
+      "review-approved",
+      "plan-revision-required",
+      "code-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "review-approved",
+    "to": [
+      "approved",
+      "plan-revision-required",
+      "code-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "approved",
+    "to": [
+      "committed",
+      "plan-revision-required",
+      "code-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "plan-revision-required",
+    "to": [
+      "planned",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "code-revision-required",
+    "to": [
+      "implementing",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ]
+  },
+  {
+    "from": "committed",
+    "to": []
+  },
+  {
+    "from": "blocked",
+    "to": []
+  },
+  {
+    "from": "escalated",
+    "to": []
+  },
+  {
+    "from": "abandoned",
+    "to": []
+  }
+]