@garygentry/feature-forge 0.1.0

package/dist/types.js

@@ -0,0 +1,57 @@
+/**
+ * Shared type system, error hierarchy, and constants for the cross-agent installer.
+ *
+ * This module is the foundation: every other module imports the types, constants, and
+ * `Result` defined here and does not redefine them (spec 00-core-definitions). Named
+ * exports only; `node:` built-ins only where applicable; zero runtime dependencies.
+ */
+// ---------------------------------------------------------------------------
+// 1. Primitive aliases and enumerations
+// ---------------------------------------------------------------------------
+/**
+ * The five coding agents this installer targets (REQ-DET-01). Order is the canonical
+ * iteration order used by detection, planning, and reporting so output is deterministic.
+ */
+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;
+/** 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.";
+// ---------------------------------------------------------------------------
+// 6. Constants — the `AGENT_TARGETS` table
+// ---------------------------------------------------------------------------
+/**
+ * The static detection map (REQ-DET-01, REQ-SCALE-01). Keyed by AgentId; iteration order
+ * follows `AGENT_IDS`. Paths for non-claude agents are "best-known" (TQ-1) — re-verify each
+ * against the agent's current config-dir/skills-dir convention at implementation (OQ-B).
+ *
+ * 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.
+ */
+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" },
+};
+/**
+ * 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.
+ */
+export const BUNDLE_REQUIRED_PATHS = {
+    /** Required of every agent bundle. */
+    common: ["skills", "scripts/forge-root.sh"],
+    /** Additional per-agent requirements. */
+    perAgent: { gemini: ["gemini-extension.json"] },
+};
+/** Success constructor. */
+export const ok = (value) => ({ ok: true, value });
+/** Failure constructor. */
+export const err = (error) => ({ ok: false, error });

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@garygentry/feature-forge",
+  "version": "0.1.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",
+  "bin": { "feature-forge": "dist/cli.js" },
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" }
+  },
+  "files": ["dist", "adapters"],
+  "engines": { "node": ">=18" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/garygentry/feature-forge.git",
+    "directory": "installer"
+  },
+  "homepage": "https://github.com/garygentry/feature-forge#readme",
+  "bugs": { "url": "https://github.com/garygentry/feature-forge/issues" },
+  "keywords": [
+    "feature-forge",
+    "cli",
+    "installer",
+    "ai-agents",
+    "claude",
+    "codex",
+    "copilot",
+    "cursor",
+    "gemini"
+  ],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test",
+    "prepack": "npm run build && node scripts/bundle-adapters.mjs"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  }
+}