@entelligentsia/forgecli 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,58 @@ All notable changes to `@entelligentsia/forgecli` are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] — 2026-05-09
+
+Headline: `/forge:init` is now a real implementation. The 0.1.0 stub at
+`src/extensions/forgecli/index.ts:77-82` is replaced with a full-parity port of
+the Claude-Code plugin's `/forge:init` flow. Default payload trimmed by 35.8%
+unpacked. Tarball size-budget gate enforced in smoke + CI.
+
+### Added
+
+- **`/forge:init` real implementation** (FORGE-S17-T02). Full parity to the
+  plugin: 4-phase flow, `--fast` / `--full` flags, resume detection via
+  `.forge/init-progress.json`, hero banner with project-name discovery, idempotent
+  re-run. Consumes `dist/forge-payload/`, substitutes placeholders against user
+  project context, writes `.forge/{personas,skills,workflows,templates,config.json,project-context.json}`.
+- **Tarball size-budget gate** (FORGE-S17-T05) at
+  `test/e2e/lib/tarball-size-gate.sh` (sourceable) plus
+  `test/e2e/size-budget.test.sh` (18 boundary assertions). Smoke gate runs after
+  `npm pack` with PASS / WARN (>35 MB) / FAIL (>50 MB) status. Thresholds
+  env-overridable via `FORGE_TARBALL_SIZE_*`.
+- **`scripts/build-payload.cjs --include-full`** flag and `--help`
+  (FORGE-S17-T04). Opt-in to the legacy un-trimmed payload for forensic /
+  round-trip verification — round-trip verified byte-exact.
+- **Mid-sprint runtime fixes** (FORGE-BUG-017..025) — `/forge:init` runtime
+  defects discovered during init-port adaptation review; pi-aware
+  `paths.forgeRoot`; skip Claude-Code-only command output during init.
+
+### Changed
+
+- **Default payload trimmed by 35.8% unpacked** (FORGE-S17-T03 audit applied
+  by FORGE-S17-T04). Files 175 → 105, unpacked 704,388 → 452,445 bytes,
+  forge-payload tar.gz 194,067 → 123,505 bytes (−36.4%). Trim sites:
+  - top-level `personas/skills/workflows/templates/` removed (Pass 1 vestige,
+    never read at runtime),
+  - `.tools/lib/` allowlisted to runtime-loaded subset
+    (`forge-root, paths, pricing, project-root, result.js, validate.js`),
+  - `.init/generation/` reduced to `generate-kb-doc.md`,
+  - `.schemas/` reduced to `*.schema.json`.
+- **Full `npm pack` output** (the published artifact, with bundled pi runtime
+  as bulk): 30.42 MB compressed, 19.58 MB headroom under the 50 MB hard gate.
+
+### Documentation
+
+- README updated with size-budget tuning surface and trimmed-payload note.
+
+### Bundled / pinned (unchanged from 0.1.0)
+
+- `@earendil-works/pi-coding-agent@0.74.0`,
+  `@earendil-works/pi-ai@0.74.0`,
+  `@earendil-works/pi-tui@0.74.0` via `bundledDependencies`.
+- `forge.bundledVersion: 0.40.3` (`Entelligentsia/forge@v0.40.3`) — drift audit
+  clean, no upstream movement during sprint.
+
 ## [0.1.0] — 2026-05-08
 
 First public stable release of `@entelligentsia/forgecli` — the Forge SDLC

package/README.md

@@ -1,52 +1,64 @@
-# forgecli
+## @entelligentsia/forgecli
 
-**Status:** Stage 1 scaffold (FORGE-S15-T01). No runtime logic yet.
+Forge SDLC on the [pi-coding-agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) runtime. Three bin aliases: `forge`, `forgecli`, `4ge`.
 
-`forgecli` is the TypeScript port of the Forge SDLC plugin, packaged as a `pi-coding-agent` extension. It will eventually expose the same workflows, personas, and tools that live in the Claude Code Forge plugin (`forge/`), but on the pi runtime.
+Bundled Forge plugin: **v0.40.3**.
+Bundled pi runtime: pinned in `package.json`.
 
-## Layout
+## Install
 
+```sh
+npm install -g @entelligentsia/forgecli
 ```
-forge-cli/
-├── package.json              ← name "forgecli", ESM, peer dep on @earendil-works/pi-coding-agent ^0.73.0
-├── tsconfig.json             ← strict, NodeNext, ES2022, outDir dist/
-├── biome.json                ← mirrors pi-mono conventions
-├── src/
-│   ├── extensions/forgecli/
-│   │   ├── index.ts          ← extension entrypoint (no-op stub)
-│   │   ├── forge-tools.ts    ← tool registration shim
-│   │   ├── forge-commands.ts ← command registration shim
-│   │   ├── hook-dispatcher.ts← hook routing shim
-│   │   ├── forge-root.ts     ← .forge/config.json resolver stub
-│   │   └── subagent/         ← T02 vendors pi-mono subagent module here
-│   └── bin/forgecli.ts       ← CLI entry stub (real impl in T03)
-├── agents/                   ← reserved for generated agents
-├── prompts/                  ← reserved for generated prompts
-├── skills/                   ← reserved for skill defs
-└── test/poc/                 ← spike tests for T04–T09
+
+Requires Node 20+.
+
+## Quick start
+
+```sh
+cd your-project
+forge                # launch interactive session (forge | forgecli | 4ge)
+> /forge:init        # bootstrap Forge SDLC — 4 phases, ~45s
 ```
 
-## Reference
+`/forge:init` is idempotent and resumable via `.forge/init-progress.json`. Re-running picks up where the previous run stopped.
 
-- `architectural-review.md` (sibling of this README) — design decisions and constraints.
-- `forge-cli-feasibility.txt` — feasibility study and PoC notes.
-- `.claude/skills/forge-cli-engineer/SKILL.md` — implementer skill (boundary rules, git protocol).
+## What `/forge:init` does
 
-## Next steps
+1. **Collect** — 5 parallel discovery scans → `.forge/config.json`
+2. **Discover** — KB doc generation + `.forge/project-context.json`
+3. **Materialize** — substitute placeholders → fully functional workflows
+4. **Register** — versioning, manifest, cache, store entries
 
-| Task | What lands |
-|---|---|
-| FORGE-S15-T02 | Vendor subagent module from pi-mono |
-| FORGE-S15-T03 | No-op extension entrypoint + `pi -e` smoke load |
-| FORGE-S15-T04–T09 | Spike R1–R6 PoCs |
-| FORGE-S15-T10 | Stage 2 gate |
+Outputs land in `.forge/{personas,skills,workflows,templates,config.json,project-context.json}` and the configured KB folder (default `engineering/`).
 
-## Build / verify (Stage 1)
+## CLI flags
 
-```bash
-cd forge-cli
-npm install
-npx tsc --noEmit
 ```
+forge --version            Print version triplet (forgecli, forge, pi)
+forge --help               Show forge + pi help
+forge --no-update-check    Skip update check
+forge --registry <path>    Override model registry
+```
+
+Pi flags (`-p`, `--cwd`, `--session`, `--model`, `--tools`, `--thinking`, …) are forwarded verbatim. Run `forge --help` for the full list.
+
+## Roadmap
+
+| Command                   | Status              |
+|---------------------------|---------------------|
+| `/forge:init`             | Shipped (0.2.0)     |
+| Other `/forge:*` commands | Roadmap             |
+
+Track via [issues](https://github.com/Entelligentsia/forge-cli/issues).
+
+## Links
+
+- Source: <https://github.com/Entelligentsia/forge-cli>
+- Issues: <https://github.com/Entelligentsia/forge-cli/issues>
+- Forge plugin (Claude Code): <https://github.com/Entelligentsia/forge>
+- Changelog: [CHANGELOG.md](./CHANGELOG.md)
+
+## License
 
-No runtime entrypoint is wired up yet — `npm run lint` and `npx tsc --noEmit` are the only meaningful verifications at this stage.
+MIT — see [LICENSE](./LICENSE).

package/dist/extensions/forgecli/forge-commands.d.ts

@@ -7,8 +7,29 @@ interface RegisterOptions {
 }
 declare function resetTomoshibiState(): void;
 export declare function registerForgeCommands(pi: ExtensionAPI, options: RegisterOptions): void;
+/** Parse YAML frontmatter from a markdown file. Returns name and description or null. */
+declare function parseFrontmatter(content: string): {
+    name: string;
+    description: string;
+} | null;
+export interface RegisterAllOptions {
+    /** Absolute path to dist/forge-payload/ (containing .base-pack/commands/). */
+    bundlePayloadRoot: string;
+    /** Current working directory (for health check). */
+    cwd?: string;
+    /** Absolute path to dist/forge-payload/ for health check bundle root. */
+    bundleRoot?: string;
+}
+/**
+ * Register all forge commands from the bundled .base-pack/commands/ directory.
+ * Commands already registered (real handlers) are skipped.
+ * Returns the number of commands registered.
+ */
+export declare function registerAllForgeCommands(pi: ExtensionAPI, options: RegisterAllOptions): number;
 export declare const __test__: {
     resetTomoshibiState: typeof resetTomoshibiState;
     getTomoshibiPending: () => boolean;
+    parseFrontmatter: typeof parseFrontmatter;
+    REAL_HANDLERS: Set<string>;
 };
 export {};

package/dist/extensions/forgecli/forge-commands.js

@@ -13,8 +13,18 @@
 // Q14 contract: every command except /forge:init no-ops gracefully
 // outside a Forge project with a notify pointing at /forge:init.
 // /forge:init is registered in index.ts (unconditional, AC#4 from T02).
+//
+// Phase G (FORGE-S17-T02): registerAllForgeCommands enumerates every
+// *.md under dist/forge-payload/.base-pack/commands/ and registers each
+// as a pi command. Real handlers for init/health/refresh-kb-links are
+// wired separately; all others emit advisory stubs.
+import * as fsSync from "node:fs";
 import { promises as fs } from "node:fs";
 import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { runRefreshKbLinks } from "./refresh-kb-links.js";
+// Resolve the package root for bundle path resolution
+const _PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
 // Tomoshibi gate — flipped true by /forge:ask, consumed by the
 // before_agent_start handler on the next turn. Module-private state is
 // safe under pi turn semantics: pi serialises agent turns, so the gate
@@ -131,10 +141,141 @@ export function registerForgeCommands(pi, options) {
         },
     });
 }
+// ── Phase G: registerAllForgeCommands (FORGE-S17-T02) ─────────────────────
+// Enumerate every *.md under dist/forge-payload/.base-pack/commands/ at
+// runtime, parse YAML frontmatter (name + description), and register each
+// via pi.registerCommand(). Real handlers for init/health/refresh-kb-links
+// are deferred to their dedicated modules (called before this function).
+// All remaining commands get advisory stub handlers.
+//
+// This function is called AFTER registerForgeInit(pi) and registerForgeCommands()
+// so that real handlers (registered first) are not overwritten.
+/** Parse YAML frontmatter from a markdown file. Returns name and description or null. */
+function parseFrontmatter(content) {
+    if (!content.startsWith("---"))
+        return null;
+    const end = content.indexOf("---", 3);
+    if (end === -1)
+        return null;
+    const block = content.slice(3, end);
+    let name = "";
+    let description = "";
+    for (const line of block.split("\n")) {
+        const m = line.match(/^(\w+):\s*(.+)$/);
+        if (!m)
+            continue;
+        if (m[1] === "name")
+            name = m[2].trim();
+        if (m[1] === "description")
+            description = m[2].trim();
+    }
+    if (!name)
+        return null;
+    return { name, description };
+}
+/** Commands that have real handlers registered by other modules OR explicitly by registerAllForgeCommands. */
+const REAL_HANDLERS = new Set([
+    "forge:init",
+    "forge:health",
+    "forge:ask",
+    "forge:config",
+    "forge:status",
+    "forge:update",
+    "forge:refresh-kb-links",
+    "forge:enhance",
+]);
+/**
+ * Register all forge commands from the bundled .base-pack/commands/ directory.
+ * Commands already registered (real handlers) are skipped.
+ * Returns the number of commands registered.
+ */
+export function registerAllForgeCommands(pi, options) {
+    const commandsDir = path.join(options.bundlePayloadRoot, ".base-pack", "commands");
+    let commandFiles;
+    try {
+        commandFiles = fsSync.readdirSync(commandsDir).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        // .base-pack not yet built — skip gracefully
+        return 0;
+    }
+    let registered = 0;
+    for (const file of commandFiles) {
+        const filePath = path.join(commandsDir, file);
+        let content;
+        try {
+            content = fsSync.readFileSync(filePath, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const meta = parseFrontmatter(content);
+        if (!meta)
+            continue;
+        const commandName = `forge:${meta.name}`;
+        // Skip commands that already have real handlers
+        if (REAL_HANDLERS.has(commandName))
+            continue;
+        // Register stub
+        const capturedName = commandName;
+        pi.registerCommand(capturedName, {
+            description: meta.description || `Forge: ${meta.name}`,
+            async handler(_args, ctx) {
+                ctx.ui.notify(`〇 ${capturedName} — full implementation in S18+.`, "info");
+            },
+        });
+        registered++;
+    }
+    // Register /forge:refresh-kb-links with real handler (Phase G)
+    const capturedCwd = options.cwd ?? process.cwd();
+    pi.registerCommand("forge:refresh-kb-links", {
+        description: "Refresh Forge KB and workflow links in agent instruction files",
+        async handler(_args, ctx) {
+            ctx.ui.setStatus?.("forge:refresh-kb-links", "Refreshing KB links…");
+            try {
+                const result = await runRefreshKbLinks(capturedCwd);
+                for (const msg of result.messages) {
+                    ctx.ui.notify(msg, "info");
+                }
+                if (result.filesUpdated === 0 && result.filesSkipped > 0) {
+                    ctx.ui.notify("forge:refresh-kb-links — all agent instruction files already up to date.", "info");
+                }
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`forge:refresh-kb-links error: ${e.message ?? "unknown"}`, "error");
+            }
+            finally {
+                ctx.ui.setStatus?.("forge:refresh-kb-links", undefined);
+            }
+        },
+    });
+    // Register /forge:enhance stub with sentinel (PLAN sub-decision #4)
+    pi.registerCommand("forge:enhance", {
+        description: "Progressive project-specific enrichment of structural elements",
+        async handler(_args, ctx) {
+            const sentinelPath = path.join(capturedCwd, ".forge", "cache", "post-init-enhancement-triggered");
+            const sentinelExists = fsSync.existsSync(sentinelPath);
+            ctx.ui.notify(`〇 forge:enhance — full implementation in S18+. ${sentinelExists ? "Sentinel already written." : "Sentinel written; auto-trigger will fire when it lands."}`, "info");
+            if (!sentinelExists) {
+                try {
+                    fsSync.mkdirSync(path.dirname(sentinelPath), { recursive: true });
+                    fsSync.writeFileSync(sentinelPath, new Date().toISOString() + "\n", "utf8");
+                }
+                catch {
+                    // non-fatal
+                }
+            }
+        },
+    });
+    return registered;
+}
 // ── Test helpers ─────────────────────────────────────────────────────────────
 // Internal — exported only for unit tests. Not part of the public API.
 export const __test__ = {
     resetTomoshibiState,
     getTomoshibiPending: () => tomoshibiPending,
+    parseFrontmatter,
+    REAL_HANDLERS,
 };
 //# sourceMappingURL=forge-commands.js.map

package/dist/extensions/forgecli/forge-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"forge-commands.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/forge-commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"forge-commands.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/forge-commands.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/forge-init.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/** Get the bundled forge-payload root (dist/forge-payload/) */
+export declare function getBundledPayloadRoot(): string;
+/** Get the bundled tools directory (dist/forge-payload/.tools/) */
+export declare function getBundledToolsRoot(): string;
+/**
+ * Resolve the absolute path to dist/forge-payload/.tools and validate it
+ * contains store-cli.cjs. Throws if the directory is missing or incomplete.
+ * Exported for test access and for Phase-4 pi-aware forgeRoot stamp.
+ */
+export declare function resolveBundleToolsRoot(): string;
+/**
+ * Detect pi runtime. forge-init.ts is only ever called from the forgecli pi
+ * extension (registerForgeInit is invoked during extension load by pi). There
+ * is no Claude Code execution path. Therefore this always returns true.
+ *
+ * We keep the guard explicit rather than hardcoding `true` so that if a future
+ * Claude Code path is added it is obvious where to insert the condition.
+ *
+ * Heuristic: PI_CODING_AGENT_DIR env set → definitely pi. Otherwise assume pi
+ * (our only caller). Only false if explicitly opted-out via env flag in a
+ * hypothetical future Claude Code integration.
+ * Exported for test access.
+ */
+export declare function isPiRuntime(): boolean;
+export declare function registerForgeInit(pi: ExtensionAPI): void;