@garygentry/feature-forge 0.1.4 → 0.2.0

package/dist/types.js

@@ -15,12 +15,22 @@
 export const AGENT_IDS = ["claude", "codex", "copilot", "cursor", "gemini"];
 /** Process exit codes (REQ-OBS-01/03, spec 07). */
 export const EXIT = { SUCCESS: 0, FAILURE: 1, USAGE: 2 };
-/** Manifest schema version; bumped only on a breaking manifest-shape change. */
-export const SCHEMA_VERSION = 1;
+/**
+ * Manifest schema version. v2 (A4b) adds the optional `placements[]` array for agents whose
+ * install spans a second filesystem root (codex `.codex/agents`, copilot `.github/copilot-
+ * instructions.md`). A v1 manifest (no `placements`) is still read verbatim by the back-compat
+ * reader — bumped only on a breaking manifest-shape change.
+ */
+export const SCHEMA_VERSION = 2;
+/** Versions of the manifest this installer can READ (write is always SCHEMA_VERSION). */
+export const READABLE_SCHEMA_VERSIONS = [1, 2];
 /** The single namespace directory name written inside each agent's install location [D5]. */
 export const FEATURE_FORGE_NS = "feature-forge";
 /** Filename prefix for the hidden parent-sibling manifest, completed by the scope (§3, spec 05). */
 export const MANIFEST_PREFIX = ".feature-forge.";
+/** HTML-comment sentinels delimiting a `managed-block` placement (mirrors rauf's convention). */
+export const MANAGED_BLOCK_START = "<!-- feature-forge:managed:start -->";
+export const MANAGED_BLOCK_END = "<!-- feature-forge:managed:end -->";
 // ---------------------------------------------------------------------------
 // 6. Constants — the `AGENT_TARGETS` table
 // ---------------------------------------------------------------------------
@@ -31,23 +41,44 @@ export const MANIFEST_PREFIX = ".feature-forge.";
  *
  * Verified ground truth: every bundle has `skills/` (11 skills), `references/`,
  * `scripts/forge-root.sh`, `agents/`; gemini adds a root `gemini-extension.json`,
- * codex adds `agents/openai.yaml`, cursor uses `.mdc` files.
+ * codex ships `skills/<name>/SKILL.md` + standalone `agents/<name>.toml` custom agents,
+ * cursor uses `.mdc` files.
+ *
+ * A4 per-agent reality check (A0 re-verified vendor docs, 2026-06-26):
+ *  - codex   — detects `.codex`, loads skills from `.agents/skills` (verified-current).
+ *              The `.codex/agents/*.toml` second placement is added in A4b.
+ *  - copilot — detects `.copilot`, but has no skills loader; the bundle is staged under
+ *              `.github/feature-forge` and the managed instructions block (.github/
+ *              copilot-instructions.md) is added in A4b (best-known).
+ *  - cursor  — `.cursor/rules/*.mdc` confirmed current (verified-current).
+ *  - gemini  — `~/.gemini/extensions/feature-forge` global confirmed; project scope is
+ *              best-known (project extension install is not clearly documented).
  */
 export const AGENT_TARGETS = {
-    claude: { id: "claude", configDirName: ".claude", installSubdir: "skills", skillFileForm: "SKILL.md", confidence: "confirmed" },
-    codex: { id: "codex", configDirName: ".codex", installSubdir: "skills", skillFileForm: "<name>.md", confidence: "best-known" },
-    copilot: { id: "copilot", configDirName: ".copilot", installSubdir: "skills", skillFileForm: "<name>.md", confidence: "best-known" },
-    cursor: { id: "cursor", configDirName: ".cursor", installSubdir: "rules", skillFileForm: "<name>.mdc", confidence: "best-known" },
-    gemini: { id: "gemini", configDirName: ".gemini", installSubdir: "extensions", skillFileForm: "<name>.md", confidence: "best-known" },
+    claude: { id: "claude", configDirName: ".claude", installBaseDir: ".claude", installSubpath: "skills", installKind: "skills", skillFileForm: "SKILL.md", confidence: "confirmed", docsUrl: "https://docs.claude.com/en/docs/claude-code/skills" },
+    codex: { id: "codex", configDirName: ".codex", installBaseDir: ".agents", installSubpath: "skills", installKind: "skills", skillFileForm: "SKILL.md", confidence: "verified-current", docsUrl: "https://developers.openai.com/codex/skills", placements: [{ kind: "mirror", baseDir: ".codex", subpath: "agents", sourcePrefix: "agents/" }] },
+    copilot: { id: "copilot", configDirName: ".copilot", installBaseDir: ".github", installSubpath: "", installKind: "instructions", skillFileForm: "<name>.md", confidence: "best-known", docsUrl: "https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions", placements: [{ kind: "managed-block", baseDir: ".github", subpath: "copilot-instructions.md" }] },
+    cursor: { id: "cursor", configDirName: ".cursor", installBaseDir: ".cursor", installSubpath: "rules", installKind: "rules", skillFileForm: "<name>.mdc", confidence: "verified-current", docsUrl: "https://cursor.com/docs/context/rules" },
+    gemini: { id: "gemini", configDirName: ".gemini", installBaseDir: ".gemini", installSubpath: "extensions", installKind: "extension", skillFileForm: "<name>.md", confidence: "verified-current", projectConfidence: "best-known", docsUrl: "https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md" },
 };
 /**
  * Minimal integrity check (REQ-OPS-06, spec 03): a located bundle is valid iff `skills/` is a
- * non-empty dir, `scripts/forge-root.sh` exists, and — for gemini only — `gemini-extension.json`
- * exists at the bundle root. Defined here as data so the check is a localized table read.
+ * non-empty dir, the neutral bundle sentinel `.feature-forge-bundle.json` exists, every runtime
+ * helper script a skill can invoke is present (so helper-backed skills run after install on ANY
+ * agent), and — for gemini only — `gemini-extension.json` exists at the bundle root. Defined here
+ * as data so the check is a localized table read.
  */
 export const BUNDLE_REQUIRED_PATHS = {
     /** Required of every agent bundle. */
-    common: ["skills", "scripts/forge-root.sh"],
+    common: [
+        "skills",
+        ".feature-forge-bundle.json",
+        "scripts/forge-root.sh",
+        "scripts/forge-init.sh",
+        "scripts/epic-manifest.py",
+        "scripts/validate-traceability.py",
+        "scripts/forge-bootstrap.py",
+    ],
     /** Additional per-agent requirements. */
     perAgent: { gemini: ["gemini-extension.json"] },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garygentry/feature-forge",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Cross-agent installer for the feature-forge skill suite — installs the canonical forge pipeline into Claude, Codex, Copilot, Cursor, or Gemini.",
   "license": "MIT",
   "type": "module",

package/adapters/codex/agents/openai.yaml

@@ -1,10 +0,0 @@
-_generated:
-  source: agents/
-  regenerate: python3 scripts/build-adapters.py
-agents:
-- name: forge-researcher
-  description: Explores the codebase to understand package structure, integration points, existing patterns, and conventions. Use during feature planning, especially when running /feature-forge:forge-2-tech. Returns a distilled integration report without polluting the main conversation's context window.
-- name: forge-spec-writer
-  description: Authors exactly one numbered implementation spec document for a forge feature, to the quality bar in forge-3-specs. Dispatched by forge-3-specs as one of several parallel writers, after the shared foundation docs (00-core-definitions, 01-architecture-layout) are already written. Writes only its single assigned file and returns a requirement-coverage manifest.
-- name: forge-verifier
-  description: Verifies feature forge pipeline artifacts for completeness, consistency, and quality. Delegates to this agent when running /feature-forge:forge-verify or when the user asks to check specs, backlog, or implementation for gaps. This agent has read-only tools and persistent memory — it cannot modify files, only analyze and report findings.