@garygentry/feature-forge 0.1.3 → 0.1.5

package/adapters/gemini/skills/forge-bootstrap/references/templates/licenses/MIT/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{YEAR}} {{AUTHOR}}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/adapters/gemini/skills/forge-bootstrap/references/templates/python/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{PROJECT_NAME}}"
+version = "0.0.0"
+description = "{{PURPOSE}}"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["mypy>=1.8", "pytest>=8.0"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.mypy]
+files = ["src", "tests"]
+strict = true
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

package/adapters/gemini/skills/forge-bootstrap/references/templates/python/src/{{PKG}}/__init__.py

@@ -0,0 +1,5 @@
+"""Package root for {{PKG}}."""
+
+from {{PKG}}.main import greet
+
+__all__ = ["greet"]

package/adapters/gemini/skills/forge-bootstrap/references/templates/python/src/{{PKG}}/main.py

@@ -0,0 +1,13 @@
+"""Entrypoint module."""
+
+
+def greet(name: str = "world") -> str:
+    """Return a greeting for ``name``.
+
+    Args:
+        name: The subject of the greeting.
+
+    Returns:
+        A greeting string.
+    """
+    return f"Hello from {name}"

package/adapters/gemini/skills/forge-bootstrap/references/templates/python/tests/test_smoke.py

@@ -0,0 +1,8 @@
+"""Smoke test for the scaffolded baseline."""
+
+from {{PKG}}.main import greet
+
+
+def test_greet() -> None:
+    """greet returns the expected greeting."""
+    assert greet("world") == "Hello from world"

package/adapters/gemini/skills/forge-bootstrap/references/templates/rust/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "{{PKG}}"
+version = "0.0.0"
+edition = "2021"
+description = "{{PURPOSE}}"
+
+[lib]
+name = "{{PKG}}"
+path = "src/lib.rs"
+
+[[bin]]
+name = "{{PKG}}"
+path = "src/main.rs"
+
+[dependencies]

package/adapters/gemini/skills/forge-bootstrap/references/templates/rust/src/lib.rs

@@ -0,0 +1,7 @@
+//! Library root for the scaffolded baseline.
+
+/// Returns the project greeting for `name`.
+#[must_use]
+pub fn greet(name: &str) -> String {
+    format!("Hello from {name}")
+}

package/adapters/gemini/skills/forge-bootstrap/references/templates/rust/src/main.rs

@@ -0,0 +1,5 @@
+use {{PKG}}::greet;
+
+fn main() {
+    println!("{}", greet("{{PROJECT_NAME}}"));
+}

package/adapters/gemini/skills/forge-bootstrap/references/templates/rust/tests/smoke.rs

@@ -0,0 +1,6 @@
+use {{PKG}}::greet;
+
+#[test]
+fn greet_returns_greeting() {
+    assert_eq!(greet("world"), "Hello from world");
+}

package/adapters/gemini/skills/forge-bootstrap/references/templates/typescript/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.0",
+  "private": true,
+  "description": "{{PURPOSE}}",
+  "type": "module",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}

package/adapters/gemini/skills/forge-bootstrap/references/templates/typescript/src/index.ts

@@ -0,0 +1,4 @@
+/** Returns the project's greeting. */
+export function greet(name: string = "{{PROJECT_NAME}}"): string {
+  return `Hello from ${name}`;
+}

package/adapters/gemini/skills/forge-bootstrap/references/templates/typescript/test/smoke.test.ts

@@ -0,0 +1,6 @@
+import { expect, test } from "vitest";
+import { greet } from "../src/index.js";
+
+test("greet returns a greeting", () => {
+  expect(greet("world")).toBe("Hello from world");
+});

package/adapters/gemini/skills/forge-bootstrap/references/templates/typescript/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["vitest/globals"]
+  },
+  "include": ["src", "test"]
+}

package/dist/cli.js

@@ -12,7 +12,7 @@
  */
 import { parseArgs } from "node:util";
 import process from "node:process";
-import { readFileSync } from "node:fs";
+import { readFileSync, realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 import * as path from "node:path";
 import { AGENT_IDS, AGENT_TARGETS, EXIT, err, ok, } from "./types.js";
@@ -496,8 +496,21 @@ function readInstallerVersion() {
 // 8. Process entry shim
 // ---------------------------------------------------------------------------
 // Only run when invoked as the bin (not when imported by tests / index.ts).
+// npm/npx install the bin as a SYMLINK (…/bin/feature-forge → …/dist/cli.js), so
+// process.argv[1] is the symlink while import.meta.url is the resolved real path —
+// resolve the symlink before comparing, or the entry point silently no-ops under
+// npx / `npm i -g` (the real invocation paths). Fall back to the raw path if argv[1]
+// is not a stat-able file.
 const entry = process.argv[1];
-if (entry !== undefined && import.meta.url === pathToFileURL(entry).href) {
+function entryHref(p) {
+    try {
+        return pathToFileURL(realpathSync(p)).href;
+    }
+    catch {
+        return pathToFileURL(p).href;
+    }
+}
+if (entry !== undefined && import.meta.url === entryHref(entry)) {
     main(process.argv.slice(2))
         .then((code) => {
         process.exitCode = code;

package/dist/manifest.d.ts

@@ -28,7 +28,7 @@ export interface BuildManifestArgs {
     readonly skills: readonly string[];
     /** SHA-256 over the source bundle's canonical (sorted-path) file set — drift anchor (spec 03). */
     readonly sourceHash: string;
-    /** Recorded pinned rauf coordinate (e.g. "@garygentry/rauf@0.7.0"); `null` when `--skip-rauf` (spec 06). */
+    /** Recorded pinned rauf coordinate (e.g. "@garygentry/rauf@0.8.0"); `null` when `--skip-rauf` (spec 06). */
     readonly raufPin: string | null;
     /** Symlink mode only: the source bundle the namespace dir links to (REQ-SAFE-02). */
     readonly link?: {

package/dist/rauf.d.ts

@@ -19,13 +19,13 @@ import { type Result } from "./types.js";
  *
  * Shape: `<name>@<version>` — the SCOPED package `@garygentry/rauf` (the unscoped `rauf` name is
  * blocked by npm's similarity filter). Advanced on each feature-forge release to a new
- * known-compatible rauf (REQ-RAUF-03). The current rauf version is 0.7.0.
+ * known-compatible rauf (REQ-RAUF-03). The current rauf version is 0.8.0.
  *
- * rauf is now PUBLISHED (rauf#28): `@garygentry/rauf@0.7.0` resolves from the npm registry, so the
+ * rauf is now PUBLISHED (rauf#28): `@garygentry/rauf@0.8.0` resolves from the npm registry, so the
  * preflight below passes by default. (Historically this pin pointed at an unpublished package and
  * the preflight was a designed-to-fail check — see the `--skip-rauf` escape hatch.)
  */
-export declare const RAUF_PIN = "@garygentry/rauf@0.7.0";
+export declare const RAUF_PIN = "@garygentry/rauf@0.8.0";
 /**
  * An injectable, READ-ONLY registry query (D1). Given a coordinate `name@version`, returns the
  * resolved version string on success, or an `InstallerError` if it is not resolvable.
@@ -37,7 +37,7 @@ export declare const RAUF_PIN = "@garygentry/rauf@0.7.0";
  * Contract: the query MUST be read-only — it MUST NOT install, MUST NOT mutate global npm
  * state, and MUST NOT execute rauf. `npm view` satisfies this (it only reads registry metadata).
  *
- * @param coordinate - the `name@version` to resolve, e.g. "@garygentry/rauf@0.7.0"
+ * @param coordinate - the `name@version` to resolve, e.g. "@garygentry/rauf@0.8.0"
  * @returns Result<string> — the resolved version on success; RAUF_UNRESOLVABLE on failure.
  */
 export type RegistryQuery = (coordinate: string) => Result<string>;

package/dist/rauf.js

@@ -20,13 +20,13 @@ import { err, ok } from "./types.js";
  *
  * Shape: `<name>@<version>` — the SCOPED package `@garygentry/rauf` (the unscoped `rauf` name is
  * blocked by npm's similarity filter). Advanced on each feature-forge release to a new
- * known-compatible rauf (REQ-RAUF-03). The current rauf version is 0.7.0.
+ * known-compatible rauf (REQ-RAUF-03). The current rauf version is 0.8.0.
  *
- * rauf is now PUBLISHED (rauf#28): `@garygentry/rauf@0.7.0` resolves from the npm registry, so the
+ * rauf is now PUBLISHED (rauf#28): `@garygentry/rauf@0.8.0` resolves from the npm registry, so the
  * preflight below passes by default. (Historically this pin pointed at an unpublished package and
  * the preflight was a designed-to-fail check — see the `--skip-rauf` escape hatch.)
  */
-export const RAUF_PIN = "@garygentry/rauf@0.7.0";
+export const RAUF_PIN = "@garygentry/rauf@0.8.0";
 /**
  * Resolvability preflight for the pinned default loop runner (D1; REQ-RAUF-01/02/03, OQ-1).
  *

package/dist/types.d.ts

@@ -124,7 +124,7 @@ export interface InstallManifest {
     readonly featureForgeVersion: string | null;
     /** SHA-256 over the source bundle's canonical (sorted-path) file set — drift anchor (OQ-4, spec 03). */
     readonly sourceHash: string;
-    /** Pinned rauf coordinate recorded at install, e.g. "@garygentry/rauf@0.7.0"; `null` if `--skip-rauf` (spec 06). */
+    /** Pinned rauf coordinate recorded at install, e.g. "@garygentry/rauf@0.8.0"; `null` if `--skip-rauf` (spec 06). */
     readonly raufPin: string | null;
     /** ISO-8601 timestamps. */
     readonly installedAt: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garygentry/feature-forge",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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",