@entelligentsia/forgecli 0.11.3 → 0.15.0

package/dist/forge-payload/schemas/structure-manifest.json

@@ -0,0 +1,511 @@
+{
+  "version": "0.46.1",
+  "generatedAt": "2026-05-22T02:09:22.016Z",
+  "generatedByTool": "build-manifest.cjs",
+  "namespaces": {
+    "personas": {
+      "logicalKey": "personas",
+      "dir": ".forge/personas",
+      "files": [
+        "architect.md",
+        "bug-fixer.md",
+        "collator.md",
+        "engineer.md",
+        "qa-engineer.md",
+        "supervisor.md"
+      ]
+    },
+    "skills": {
+      "logicalKey": "skills",
+      "dir": ".forge/skills",
+      "files": [
+        "architect-skills.md",
+        "bug-fixer-skills.md",
+        "collator-skills.md",
+        "engineer-skills.md",
+        "generic-skills.md",
+        "qa-engineer-skills.md",
+        "supervisor-skills.md"
+      ]
+    },
+    "workflows": {
+      "logicalKey": "workflows",
+      "dir": ".forge/workflows",
+      "files": [
+        "architect_approve.md",
+        "architect_review_sprint_completion.md",
+        "architect_sprint_intake.md",
+        "architect_sprint_plan.md",
+        "collator_agent.md",
+        "commit_task.md",
+        "fix_bug.md",
+        "implement_plan.md",
+        "migrate_structural.md",
+        "orchestrate_task.md",
+        "plan_task.md",
+        "quiz_agent.md",
+        "review_code.md",
+        "review_plan.md",
+        "run_sprint.md",
+        "sprint_retrospective.md",
+        "update_implementation.md",
+        "update_plan.md",
+        "validate_task.md"
+      ]
+    },
+    "templates": {
+      "logicalKey": "templates",
+      "dir": ".forge/templates",
+      "files": [
+        "CODE_REVIEW_TEMPLATE.md",
+        "COST_REPORT_TEMPLATE.md",
+        "PLAN_REVIEW_TEMPLATE.md",
+        "PLAN_SUMMARY_TEMPLATE.json",
+        "PLAN_TEMPLATE.md",
+        "PROGRESS_TEMPLATE.md",
+        "RETROSPECTIVE_TEMPLATE.md",
+        "SPRINT_MANIFEST_TEMPLATE.md",
+        "SPRINT_REQUIREMENTS_TEMPLATE.md",
+        "TASK_PROMPT_TEMPLATE.md"
+      ]
+    },
+    "commands": {
+      "logicalKey": "commands",
+      "dir": ".claude/commands",
+      "prefixed": true,
+      "files": [
+        "approve.md",
+        "collate.md",
+        "commit.md",
+        "enhance.md",
+        "fix-bug.md",
+        "implement.md",
+        "plan.md",
+        "quiz-agent.md",
+        "retrospective.md",
+        "review-code.md",
+        "review-plan.md",
+        "run-sprint.md",
+        "run-task.md",
+        "sprint-intake.md",
+        "sprint-plan.md",
+        "validate.md"
+      ]
+    },
+    "fragments": {
+      "logicalKey": "fragments",
+      "dir": ".forge/workflows/_fragments",
+      "files": [
+        "context-injection.md",
+        "event-emission-schema.md",
+        "finalize.md",
+        "friction-emit.md",
+        "progress-reporting.md",
+        "store-cli-verbs.md"
+      ]
+    },
+    "schemas": {
+      "logicalKey": "schemas",
+      "dir": ".forge/schemas",
+      "files": [
+        "bug.schema.json",
+        "collation-state.schema.json",
+        "config.schema.json",
+        "event-sidecar.schema.json",
+        "event.schema.json",
+        "feature.schema.json",
+        "progress-entry.schema.json",
+        "project-context.schema.json",
+        "project-overlay.schema.json",
+        "proposal.schema.json",
+        "sprint.schema.json",
+        "structure-versions.schema.json",
+        "task.schema.json"
+      ]
+    }
+  },
+  "edges": {
+    "workflows": {
+      "architect_approve": {
+        "personas": [
+          ".forge/personas/architect.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "collator_agent": {
+        "personas": [
+          ".forge/personas/collator.md"
+        ],
+        "skills": [
+          ".forge/skills/collator-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/MASTER_INDEX.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "commit_task": {
+        "personas": [
+          ".forge/personas/engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PROGRESS_TEMPLATE.md"
+        ],
+        "sub_workflows": [],
+        "kb_docs": [],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "fix_bug": {
+        "personas": [
+          ".forge/personas/bug-fixer.md",
+          ".forge/personas/supervisor.md",
+          ".forge/personas/architect.md",
+          ".forge/personas/engineer.md",
+          ".forge/personas/collator.md"
+        ],
+        "skills": [
+          ".forge/skills/bug-fixer-skills.md",
+          ".forge/skills/supervisor-skills.md",
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PROGRESS_TEMPLATE.md"
+        ],
+        "sub_workflows": [
+          ".forge/workflows/plan_task.md",
+          ".forge/workflows/implement_plan.md",
+          ".forge/workflows/review_plan.md",
+          ".forge/workflows/review_code.md",
+          ".forge/workflows/architect_approve.md",
+          ".forge/workflows/commit_task.md"
+        ],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md",
+          "{KB_PATH}/architecture/routing.md"
+        ],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "implement_plan": {
+        "personas": [
+          ".forge/personas/engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PROGRESS_TEMPLATE.md"
+        ],
+        "sub_workflows": [
+          ".forge/workflows/review_code.md"
+        ],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md",
+          "{KB_PATH}/architecture/routing.md"
+        ],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "orchestrate_task": {
+        "personas": [
+          ".forge/personas/architect.md",
+          ".forge/personas/engineer.md",
+          ".forge/personas/supervisor.md",
+          ".forge/personas/bug-fixer.md",
+          ".forge/personas/collator.md",
+          ".forge/personas/qa-engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/engineer-skills.md",
+          ".forge/skills/supervisor-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [
+          ".forge/workflows/plan_task.md",
+          ".forge/workflows/implement_plan.md",
+          ".forge/workflows/review_plan.md",
+          ".forge/workflows/review_code.md",
+          ".forge/workflows/fix_bug.md",
+          ".forge/workflows/architect_approve.md",
+          ".forge/workflows/commit_task.md",
+          ".forge/workflows/validate_task.md"
+        ],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "plan_task": {
+        "personas": [
+          ".forge/personas/architect.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PLAN_TEMPLATE.md",
+          ".forge/templates/TASK_PROMPT_TEMPLATE.md"
+        ],
+        "sub_workflows": [
+          ".forge/workflows/review_plan.md"
+        ],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "sprint_retrospective": {
+        "personas": [
+          ".forge/personas/architect.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/RETROSPECTIVE_TEMPLATE.md"
+        ],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "review_code": {
+        "personas": [
+          ".forge/personas/supervisor.md"
+        ],
+        "skills": [
+          ".forge/skills/supervisor-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/CODE_REVIEW_TEMPLATE.md"
+        ],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md",
+          "{KB_PATH}/architecture/routing.md"
+        ],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "review_plan": {
+        "personas": [
+          ".forge/personas/supervisor.md"
+        ],
+        "skills": [
+          ".forge/skills/supervisor-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PLAN_REVIEW_TEMPLATE.md"
+        ],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "architect_review_sprint_completion": {
+        "personas": [
+          ".forge/personas/architect.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "architect_sprint_intake": {
+        "personas": [
+          ".forge/personas/product-manager.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/SPRINT_REQUIREMENTS_TEMPLATE.md",
+          ".forge/templates/SPRINT_MANIFEST_TEMPLATE.md"
+        ],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/MASTER_INDEX.md",
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "project.prefix",
+          "paths.engineering"
+        ]
+      },
+      "architect_sprint_plan": {
+        "personas": [
+          ".forge/personas/architect.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/SPRINT_MANIFEST_TEMPLATE.md",
+          ".forge/templates/TASK_PROMPT_TEMPLATE.md"
+        ],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/MASTER_INDEX.md",
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "project.prefix",
+          "paths.engineering"
+        ]
+      },
+      "update_implementation": {
+        "personas": [
+          ".forge/personas/engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PROGRESS_TEMPLATE.md"
+        ],
+        "sub_workflows": [
+          ".forge/workflows/review_code.md"
+        ],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "update_plan": {
+        "personas": [
+          ".forge/personas/architect.md"
+        ],
+        "skills": [
+          ".forge/skills/architect-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [
+          ".forge/templates/PLAN_TEMPLATE.md"
+        ],
+        "sub_workflows": [
+          ".forge/workflows/review_plan.md"
+        ],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "validate_task": {
+        "personas": [
+          ".forge/personas/qa-engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/qa-engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md"
+        ],
+        "config_fields": [
+          "commands.test",
+          "paths.engineering"
+        ]
+      },
+      "quiz_agent": {
+        "personas": [
+          ".forge/personas/qa-engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/qa-engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [],
+        "kb_docs": [
+          "{KB_PATH}/architecture/stack.md",
+          "{KB_PATH}/MASTER_INDEX.md"
+        ],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      },
+      "migrate_structural": {
+        "personas": [
+          ".forge/personas/engineer.md"
+        ],
+        "skills": [
+          ".forge/skills/engineer-skills.md",
+          ".forge/skills/generic-skills.md"
+        ],
+        "templates": [],
+        "sub_workflows": [],
+        "kb_docs": [],
+        "config_fields": [
+          "paths.engineering"
+        ]
+      }
+    }
+  }
+}

package/dist/forge-payload/tools/compression-gate.cjs

@@ -0,0 +1,192 @@
+'use strict';
+// FORGE-S24-T06 — compression gate (reject >20% growth without 3+ frictions).
+//
+// Phase 2 of meta-enhance runs this gate BEFORE the LLM judge (T03). The gate
+// is a cheap deterministic filter: an `update_skill` proposal that grows the
+// target file by more than 20% (byte-wise) must be backed by at least 3
+// supporting friction events. Insufficient support → reject; the judge never
+// sees the proposal.
+//
+// Why a cheap pre-judge gate?
+//   - Judging is expensive (LLM call).
+//   - Unbounded growth of a skill body is the classic SkillOS failure mode —
+//     adding pages of trajectory copy-paste to "patch" a friction. Cheap to
+//     detect deterministically; wasteful to ask the judge to rule on.
+//
+// Op semantics:
+//   - `insert_skill`: not gated — the file doesn't exist yet, "growth" is
+//     undefined; the judge's body_under_2kb axis handles bloat instead.
+//   - `delete_skill`: not gated — deletion always shrinks.
+//   - `update_skill`: GATED. Growth is measured byte-wise (UTF-8) on the new
+//     body that would land after applying the diff. The caller resolves the
+//     "currentBody" and "newBody" by reading the file and applying the patch.
+//
+// Friction support:
+//   - Default: `proposal.sourceFrictionIds.length`.
+//   - Override: caller may supply `supportingFrictionCountFor(proposal) -> int`
+//     when the policy is "count frictions citing the same skill across the
+//     sprint" rather than "count citations on the proposal itself".
+//
+// Pure module: no fs access, no LLM call. Consumed by Phase 2 between
+// step 5b (delete-candidate detection) and step 5c (LLM-judge gate).
+//
+// Exports:
+//   GROWTH_THRESHOLD                       — 0.20 (strict >, ties admit).
+//   MIN_SUPPORTING_FRICTIONS               — 3.
+//   evaluateGrowth({ currentBody, newBody })
+//     -> { currentBytes, newBytes, growthRatio }
+//   evaluateProposal({ proposal, currentBody, newBody, supportingFrictionCount })
+//     -> { admit, reason, growthRatio, currentBytes, newBytes,
+//          supportingFrictionCount, threshold, minSupportingFrictions, op }
+//   filterProposals({ proposals, currentBodyFor, newBodyFor,
+//                     supportingFrictionCountFor })
+//     -> { admitted: proposal[], rejected: { proposal, ...evaluation }[] }
+
+const GROWTH_THRESHOLD         = 0.20;
+const MIN_SUPPORTING_FRICTIONS = 3;
+
+const VALID_OPS = new Set(['insert_skill', 'update_skill', 'delete_skill']);
+
+function evaluateGrowth({ currentBody, newBody }) {
+  if (typeof currentBody !== 'string') {
+    throw new TypeError('currentBody must be a string');
+  }
+  if (typeof newBody !== 'string') {
+    throw new TypeError('newBody must be a string');
+  }
+  const currentBytes = Buffer.byteLength(currentBody, 'utf8');
+  const newBytes     = Buffer.byteLength(newBody,     'utf8');
+  // When currentBytes === 0 the ratio is undefined for update; we return
+  // Infinity and let the caller decide. evaluateProposal treats Infinity as
+  // "over threshold" — an update on an empty file is, by definition,
+  // unbounded growth — so the friction-support gate still applies.
+  const growthRatio = currentBytes === 0
+    ? (newBytes === 0 ? 0 : Infinity)
+    : (newBytes - currentBytes) / currentBytes;
+  return { currentBytes, newBytes, growthRatio };
+}
+
+function evaluateProposal({
+  proposal,
+  currentBody,
+  newBody,
+  supportingFrictionCount,
+}) {
+  if (!proposal || typeof proposal !== 'object') {
+    throw new TypeError('proposal must be an object');
+  }
+  if (typeof proposal.op !== 'string' || !VALID_OPS.has(proposal.op)) {
+    throw new TypeError(
+      `proposal.op must be one of ${Array.from(VALID_OPS).join(', ')}; got ${JSON.stringify(proposal.op)}`,
+    );
+  }
+  if (typeof currentBody !== 'string') {
+    throw new TypeError('currentBody must be a string');
+  }
+  if (typeof newBody !== 'string') {
+    throw new TypeError('newBody must be a string');
+  }
+
+  // Resolve supporting friction count — explicit > proposal.sourceFrictionIds.
+  let frictionCount;
+  if (supportingFrictionCount === undefined) {
+    frictionCount = Array.isArray(proposal.sourceFrictionIds)
+      ? proposal.sourceFrictionIds.length
+      : 0;
+  } else {
+    if (!Number.isInteger(supportingFrictionCount) || supportingFrictionCount < 0) {
+      throw new TypeError(
+        'supportingFrictionCount must be a non-negative integer',
+      );
+    }
+    frictionCount = supportingFrictionCount;
+  }
+
+  const { currentBytes, newBytes, growthRatio } = evaluateGrowth({
+    currentBody, newBody,
+  });
+
+  const base = {
+    growthRatio,
+    currentBytes,
+    newBytes,
+    supportingFrictionCount: frictionCount,
+    threshold:               GROWTH_THRESHOLD,
+    minSupportingFrictions:  MIN_SUPPORTING_FRICTIONS,
+    op:                      proposal.op,
+  };
+
+  // Non-update ops are not gated.
+  if (proposal.op !== 'update_skill') {
+    return { admit: true, reason: 'op_not_gated', ...base };
+  }
+
+  // Strict >: growth exactly at threshold admits.
+  if (!(growthRatio > GROWTH_THRESHOLD)) {
+    return { admit: true, reason: 'admitted_below_threshold', ...base };
+  }
+
+  // Over threshold — admit only if enough friction support.
+  if (frictionCount >= MIN_SUPPORTING_FRICTIONS) {
+    return { admit: true, reason: 'admitted_with_friction_support', ...base };
+  }
+
+  return { admit: false, reason: 'compression_gate_growth_unsupported', ...base };
+}
+
+function filterProposals({
+  proposals,
+  currentBodyFor,
+  newBodyFor,
+  supportingFrictionCountFor,
+}) {
+  if (!Array.isArray(proposals)) {
+    throw new TypeError('proposals must be an array');
+  }
+  if (typeof currentBodyFor !== 'function') {
+    throw new TypeError('currentBodyFor must be a function');
+  }
+  if (typeof newBodyFor !== 'function') {
+    throw new TypeError('newBodyFor must be a function');
+  }
+  if (
+    supportingFrictionCountFor !== undefined &&
+    typeof supportingFrictionCountFor !== 'function'
+  ) {
+    throw new TypeError('supportingFrictionCountFor must be a function when provided');
+  }
+
+  const admitted = [];
+  const rejected = [];
+
+  for (const proposal of proposals) {
+    const currentBody = currentBodyFor(proposal);
+    const newBody     = newBodyFor(proposal);
+    const supportingFrictionCount = supportingFrictionCountFor
+      ? supportingFrictionCountFor(proposal)
+      : undefined;
+
+    const evaluation = evaluateProposal({
+      proposal,
+      currentBody,
+      newBody,
+      supportingFrictionCount,
+    });
+
+    if (evaluation.admit) {
+      admitted.push(proposal);
+    } else {
+      rejected.push({ proposal, ...evaluation });
+    }
+  }
+
+  return { admitted, rejected };
+}
+
+module.exports = {
+  GROWTH_THRESHOLD,
+  MIN_SUPPORTING_FRICTIONS,
+  evaluateGrowth,
+  evaluateProposal,
+  filterProposals,
+};