@h9-foundry/agentforge-cli 0.3.0

package/dist/index.js

@@ -0,0 +1,385 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import yaml from "js-yaml";
+import { renderAuditBundleMarkdown } from "@h9-foundry/agentforge-audit";
+import { createWorkflowState, findWorkspaceRoot } from "@h9-foundry/agentforge-context-engine";
+import { createPolicyEngine, loadPolicyDocument, resolvePolicy } from "@h9-foundry/agentforge-policy-engine";
+import { runWorkflow } from "@h9-foundry/agentforge-runtime";
+import { agentforgeConfigSchema, workflowDefinitionSchema } from "@h9-foundry/agentforge-schemas";
+import { createBuiltinAdapters } from "./internal/builtin-adapters.js";
+import { createBuiltinAgentRegistry } from "./internal/builtin-agents.js";
+import { LocalPluginRegistry } from "./internal/local-plugin-registry.js";
+export { checkReleaseReadiness, getReleaseGuide, renderReleaseGuide, TARGET_NPM_SCOPE, EXPECTED_PUBLIC_PACKAGES } from "./internal/release-preflight.js";
+export { verifyReleaseArtifacts } from "./internal/release-verification.js";
+const agentforgeConfigTemplate = `version: 1
+project:
+  name: REPO_NAME
+  language: typescript
+runtime:
+  mode: inspect
+  runs_path: .agentops/runs
+providers:
+  default: disabled
+reporting:
+  github:
+    tracker_issue: 1
+plugins:
+  agents: []
+`;
+const policyTemplate = `version: 1
+defaults:
+  execution_mode: inspect
+  model_access: false
+  network: deny
+  writes: approval_required
+paths:
+  allowed_read:
+    - "**/*"
+  allowed_write:
+    - ".agentops/runs/**"
+    - "tests/**"
+  blocked:
+    - ".env*"
+    - "**/.env*"
+    - "secrets/**"
+    - "**/*.pem"
+    - "**/*.key"
+    - "**/id_rsa*"
+    - "infra/prod/**"
+plugins:
+  allowed_tiers:
+    - core
+    - verified
+  allowed_sources:
+    - official
+    - local
+  require_reviewed: true
+tools:
+  git.status:
+    effect: allow
+  git.diff-summary:
+    effect: allow
+  filesystem.read-file:
+    effect: allow
+  filesystem.list-files:
+    effect: allow
+  filesystem.write-file:
+    effect: approval_required
+  shell.run-template:
+    effect: deny
+  github.create-check:
+    effect: deny
+`;
+const workflowTemplate = `version: 1
+name: pr-review
+trigger: manual
+nodes:
+  - id: context
+    kind: deterministic
+    agent: context-collector
+    outputs_to: agentResults.context
+  - id: security
+    kind: reasoning
+    agent: security-audit
+    outputs_to: agentResults.security
+  - id: review
+    kind: reasoning
+    agent: code-review
+    outputs_to: agentResults.review
+  - id: tests
+    kind: reasoning
+    agent: test-generation
+    outputs_to: agentResults.tests
+  - id: report
+    kind: report
+    outputs_to: reports.final
+`;
+function loadYaml(filePath) {
+    return yaml.load(readFileSync(filePath, "utf8"));
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeWorkflow(input) {
+    const parsed = input;
+    return workflowDefinitionSchema.parse({
+        version: parsed.version,
+        name: parsed.name,
+        description: parsed.description,
+        trigger: parsed.trigger,
+        nodes: Array.isArray(parsed.nodes)
+            ? parsed.nodes.map((node) => {
+                const record = node;
+                return {
+                    id: record.id,
+                    kind: record.kind,
+                    agent: record.agent,
+                    outputsTo: record.outputs_to ?? record.outputsTo,
+                    contextSections: record.context_sections ?? record.contextSections ?? [],
+                    tools: record.tools ?? []
+                };
+            })
+            : []
+    });
+}
+function normalizeAgentForgeConfigInput(value) {
+    if (!isRecord(value)) {
+        return value;
+    }
+    const runtime = isRecord(value.runtime) ? value.runtime : {};
+    const reporting = isRecord(value.reporting) ? value.reporting : {};
+    const github = isRecord(reporting.github) ? reporting.github : {};
+    const providers = isRecord(value.providers) ? value.providers : {};
+    const plugins = isRecord(value.plugins) ? value.plugins : {};
+    const project = isRecord(value.project) ? value.project : {};
+    return {
+        version: value.version,
+        project: {
+            name: project.name ?? "repo",
+            language: project.language ?? "typescript"
+        },
+        runtime: {
+            mode: runtime.mode,
+            runsPath: runtime.runs_path ?? runtime.runsPath
+        },
+        providers: {
+            default: providers.default ?? "disabled"
+        },
+        reporting: {
+            github: Object.keys(github).length > 0
+                ? {
+                    trackerIssue: github.tracker_issue ?? github.trackerIssue
+                }
+                : undefined
+        },
+        plugins: {
+            agents: Array.isArray(plugins.agents)
+                ? plugins.agents.map((entry) => {
+                    const record = entry;
+                    return {
+                        name: record.name,
+                        package: record.package,
+                        enabled: record.enabled
+                    };
+                })
+                : []
+        }
+    };
+}
+function loadAgentForgeConfig(root) {
+    const configPath = join(root, ".agentops", "agentops.yaml");
+    if (!existsSync(configPath)) {
+        return agentforgeConfigSchema.parse({
+            version: 1,
+            project: {
+                name: root.split("/").at(-1) ?? "repo",
+                language: "typescript"
+            },
+            runtime: {
+                mode: "inspect",
+                runsPath: ".agentops/runs"
+            },
+            providers: {
+                default: "disabled"
+            },
+            reporting: {},
+            plugins: {
+                agents: []
+            }
+        });
+    }
+    const parsed = loadYaml(configPath);
+    return agentforgeConfigSchema.parse(normalizeAgentForgeConfigInput(parsed));
+}
+function ensureDirectory(pathValue) {
+    mkdirSync(pathValue, { recursive: true });
+}
+function ensureInitFiles(root) {
+    const created = [];
+    const configDir = join(root, ".agentops");
+    const workflowsDir = join(configDir, "workflows");
+    ensureDirectory(workflowsDir);
+    const files = [
+        {
+            path: join(configDir, "agentops.yaml"),
+            contents: agentforgeConfigTemplate.replace("REPO_NAME", root.split("/").at(-1) ?? "repo")
+        },
+        {
+            path: join(configDir, "policy.yaml"),
+            contents: policyTemplate
+        },
+        {
+            path: join(workflowsDir, "pr-review.yaml"),
+            contents: workflowTemplate
+        }
+    ];
+    for (const file of files) {
+        if (!existsSync(file.path)) {
+            writeFileSync(file.path, file.contents, "utf8");
+            created.push(file.path);
+        }
+    }
+    return created;
+}
+function buildBuiltinAgentRegistry() {
+    return createBuiltinAgentRegistry();
+}
+function buildAdapterRegistry() {
+    return new Map(createBuiltinAdapters().map((adapter) => [adapter.manifest.name, adapter]));
+}
+function createBlockedPlugin(registration, reason, trust) {
+    return {
+        name: registration.name,
+        package: registration.package,
+        reason,
+        ...(trust ? { trust } : {})
+    };
+}
+async function buildAgentRegistry(root, config, workflowName) {
+    const agents = buildBuiltinAgentRegistry();
+    const registryClient = new LocalPluginRegistry(root);
+    const policy = resolvePolicy(loadPolicyDocument(join(root, ".agentops", "policy.yaml")), process.env.CI ? "ci" : "local");
+    const policyEngine = createPolicyEngine(policy, root);
+    const blockedPlugins = [];
+    for (const registration of config.plugins.agents) {
+        if (!registration.enabled) {
+            continue;
+        }
+        if (agents.has(registration.name)) {
+            blockedPlugins.push(createBlockedPlugin(registration, `Plugin name collides with an existing agent: ${registration.name}`));
+            continue;
+        }
+        try {
+            const pluginAgent = await registryClient.loadLocalAgentPlugin(registration.package);
+            if (pluginAgent.manifest.name !== registration.name) {
+                blockedPlugins.push(createBlockedPlugin(registration, `Registered plugin name ${registration.name} does not match exported manifest name ${pluginAgent.manifest.name}`, pluginAgent.manifest.trust));
+                continue;
+            }
+            const trustDecision = policyEngine.evaluatePluginTrust(pluginAgent.manifest.name, pluginAgent.manifest.trust);
+            if (!trustDecision.allowed) {
+                blockedPlugins.push(createBlockedPlugin(registration, trustDecision.reason ?? "Plugin denied by trust policy.", pluginAgent.manifest.trust));
+                continue;
+            }
+            agents.set(pluginAgent.manifest.name, pluginAgent);
+        }
+        catch (error) {
+            blockedPlugins.push(createBlockedPlugin(registration, error instanceof Error ? error.message : `Failed to load plugin for workflow ${workflowName}`, undefined));
+        }
+    }
+    return { agents, blockedPlugins, policy, policyEngine };
+}
+function validateWorkflowAgents(workflow, agents, blockedPlugins) {
+    const blockedByName = new Map(blockedPlugins.map((plugin) => [plugin.name, plugin]));
+    for (const node of workflow.nodes) {
+        if (!node.agent) {
+            continue;
+        }
+        if (agents.has(node.agent)) {
+            continue;
+        }
+        const blocked = blockedByName.get(node.agent);
+        if (blocked) {
+            throw new Error(`Workflow agent ${node.agent} is blocked: ${blocked.reason}`);
+        }
+        throw new Error(`Workflow agent is not registered: ${node.agent}`);
+    }
+}
+export function initProject(cwd = process.cwd()) {
+    const root = findWorkspaceRoot(cwd);
+    const created = ensureInitFiles(root);
+    return { root, created };
+}
+export function scanProject(cwd = process.cwd()) {
+    const root = findWorkspaceRoot(cwd);
+    ensureInitFiles(root);
+    const policyPath = join(root, ".agentops", "policy.yaml");
+    const policy = resolvePolicy(loadPolicyDocument(policyPath), process.env.CI ? "ci" : "local");
+    const state = createWorkflowState({
+        cwd: root,
+        workflow: "pr-review",
+        mode: "inspect",
+        policy
+    });
+    const risks = state.changes.changedFiles.filter((filePath) => /(^\.env|(^|\/)\.env|^secrets\/|^infra\/prod\/|\.pem$|\.key$|(^|\/)id_rsa)/.test(filePath));
+    return {
+        root,
+        packageManager: state.repo.packageManager,
+        languages: state.repo.languages,
+        changedFiles: state.changes.changedFiles,
+        recommendations: ["context-collector", "security-audit", "code-review", "test-generation"],
+        risks
+    };
+}
+export async function runLocalWorkflow(workflowName, cwd = process.cwd()) {
+    const root = findWorkspaceRoot(cwd);
+    ensureInitFiles(root);
+    const config = loadAgentForgeConfig(root);
+    const workflow = normalizeWorkflow(loadYaml(join(root, ".agentops", "workflows", `${workflowName}.yaml`)));
+    const { agents, blockedPlugins, policy, policyEngine } = await buildAgentRegistry(root, config, workflowName);
+    validateWorkflowAgents(workflow, agents, blockedPlugins);
+    const state = createWorkflowState({
+        cwd: root,
+        workflow: workflow.name,
+        mode: policy.defaults.executionMode,
+        policy,
+        trigger: workflow.trigger
+    });
+    state.blockedPlugins = blockedPlugins;
+    const runsRoot = join(root, config.runtime.runsPath);
+    const outputDir = join(runsRoot, state.runId);
+    ensureDirectory(outputDir);
+    const artifactJsonPath = join(outputDir, "bundle.json");
+    const artifactMarkdownPath = join(outputDir, "summary.md");
+    const { bundle } = await runWorkflow({
+        workflow,
+        initialState: state,
+        agents,
+        adapters: buildAdapterRegistry(),
+        policyEngine,
+        artifactJsonPath,
+        artifactMarkdownPath
+    });
+    const markdownReport = renderAuditBundleMarkdown(bundle);
+    writeFileSync(artifactJsonPath, JSON.stringify(bundle, null, 2), "utf8");
+    writeFileSync(artifactMarkdownPath, markdownReport, "utf8");
+    const blockedActions = bundle.entries.reduce((total, entry) => total + entry.blockedActions.length, 0);
+    return {
+        runId: bundle.runId,
+        outputDir,
+        markdownReport,
+        jsonPath: artifactJsonPath,
+        markdownPath: artifactMarkdownPath,
+        status: bundle.status,
+        findings: bundle.findings.length,
+        blockedActions,
+        blockedPlugins: bundle.blockedPlugins.length
+    };
+}
+export function explainLastRun(cwd = process.cwd()) {
+    const root = findWorkspaceRoot(cwd);
+    const config = loadAgentForgeConfig(root);
+    const runsRoot = join(root, config.runtime.runsPath);
+    const entries = existsSync(runsRoot) ? readdirSync(runsRoot).sort() : [];
+    const latest = entries.at(-1);
+    if (!latest) {
+        throw new Error("No recorded runs found.");
+    }
+    const bundle = JSON.parse(readFileSync(join(runsRoot, latest, "bundle.json"), "utf8"));
+    return {
+        runId: bundle.runId,
+        status: bundle.status,
+        findings: bundle.findings.length,
+        blockedActions: bundle.entries.reduce((total, entry) => total + entry.blockedActions.length, 0),
+        blockedPlugins: bundle.blockedPlugins.length,
+        jsonPath: join(runsRoot, latest, "bundle.json"),
+        markdownPath: join(runsRoot, latest, "summary.md")
+    };
+}
+export function getGitHubReportingConfig(cwd = process.cwd()) {
+    const root = findWorkspaceRoot(cwd);
+    const config = loadAgentForgeConfig(root);
+    return {
+        trackerIssue: config.reporting.github?.trackerIssue
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/internal/builtin-adapters.d.ts

@@ -0,0 +1,3 @@
+import type { ToolAdapter } from "@h9-foundry/agentforge-sdk";
+export declare function createBuiltinAdapters(): ToolAdapter[];
+//# sourceMappingURL=builtin-adapters.d.ts.map

package/dist/internal/builtin-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-adapters.d.ts","sourceRoot":"","sources":["../../src/internal/builtin-adapters.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA2E9D,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CA6KrD"}

package/dist/internal/builtin-adapters.js

@@ -0,0 +1,239 @@
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { dirname, relative, resolve } from "node:path";
+import { promisify } from "node:util";
+import { z } from "zod";
+const execFileAsync = promisify(execFile);
+const readFileInputSchema = z.object({
+    path: z.string().min(1)
+});
+const readFileOutputSchema = z.object({
+    path: z.string().min(1),
+    contents: z.string()
+});
+const listFilesInputSchema = z.object({
+    path: z.string().min(1).default(".")
+});
+const listFilesOutputSchema = z.object({
+    path: z.string().min(1),
+    entries: z.array(z.string())
+});
+const writeFileInputSchema = z.object({
+    path: z.string().min(1),
+    contents: z.string()
+});
+const writeFileOutputSchema = z.object({
+    path: z.string().min(1),
+    bytesWritten: z.number().min(0)
+});
+const emptyInputSchema = z.object({});
+const statusOutputSchema = z.object({
+    lines: z.array(z.string())
+});
+const diffSummaryOutputSchema = z.object({
+    summary: z.string()
+});
+const runTemplateInputSchema = z.object({
+    templateId: z.string().min(1)
+});
+const runTemplateOutputSchema = z.object({
+    templateId: z.string().min(1),
+    stdout: z.string(),
+    stderr: z.string()
+});
+const createCheckInputSchema = z.object({
+    repository: z.string().min(1),
+    title: z.string().min(1),
+    summary: z.string().min(1)
+});
+const createCheckOutputSchema = z.object({
+    accepted: z.boolean(),
+    message: z.string()
+});
+const allowedTemplates = {
+    "git-status": { command: "git", args: ["status", "--short"] },
+    "git-diff-stat": { command: "git", args: ["diff", "--stat", "HEAD"] }
+};
+function resolveRepositoryPath(root, requestedPath) {
+    const absolutePath = resolve(root, requestedPath);
+    const relativePath = relative(root, absolutePath);
+    if (relativePath.startsWith("..") || relativePath === "..") {
+        throw new Error(`Path escapes repository root: ${requestedPath}`);
+    }
+    return absolutePath;
+}
+export function createBuiltinAdapters() {
+    return [
+        {
+            manifest: {
+                name: "filesystem.read-file",
+                description: "Read a UTF-8 text file from the repository.",
+                inputSchema: readFileInputSchema,
+                outputSchema: readFileOutputSchema,
+                sideEffectClass: "observe",
+                permission: "read",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "core",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute(input, context) {
+                const parsed = readFileInputSchema.parse(input);
+                const decision = context.policy.canReadPath(parsed.path);
+                if (!decision.allowed) {
+                    throw new Error(decision.reason ?? `Read denied for ${parsed.path}`);
+                }
+                const absolutePath = resolveRepositoryPath(context.workingDirectory, parsed.path);
+                const contents = await readFile(absolutePath, "utf8");
+                return readFileOutputSchema.parse({ path: parsed.path, contents });
+            }
+        },
+        {
+            manifest: {
+                name: "filesystem.list-files",
+                description: "List files in a repository directory.",
+                inputSchema: listFilesInputSchema,
+                outputSchema: listFilesOutputSchema,
+                sideEffectClass: "observe",
+                permission: "read",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "core",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute(input, context) {
+                const parsed = listFilesInputSchema.parse(input);
+                const decision = context.policy.canReadPath(parsed.path);
+                if (!decision.allowed) {
+                    throw new Error(decision.reason ?? `Directory listing denied for ${parsed.path}`);
+                }
+                const absolutePath = resolveRepositoryPath(context.workingDirectory, parsed.path);
+                const entries = await readdir(absolutePath);
+                return listFilesOutputSchema.parse({ path: parsed.path, entries });
+            }
+        },
+        {
+            manifest: {
+                name: "filesystem.write-file",
+                description: "Write a UTF-8 text file inside the repository.",
+                inputSchema: writeFileInputSchema,
+                outputSchema: writeFileOutputSchema,
+                sideEffectClass: "apply-low-risk",
+                permission: "write",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "core",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute(input, context) {
+                const parsed = writeFileInputSchema.parse(input);
+                const decision = context.policy.canWritePath(parsed.path);
+                if (!decision.allowed || decision.requiresApproval) {
+                    throw new Error(decision.reason ?? `Write denied for ${parsed.path}`);
+                }
+                const absolutePath = resolveRepositoryPath(context.workingDirectory, parsed.path);
+                await mkdir(dirname(absolutePath), { recursive: true });
+                await writeFile(absolutePath, parsed.contents, "utf8");
+                return writeFileOutputSchema.parse({ path: parsed.path, bytesWritten: Buffer.byteLength(parsed.contents) });
+            }
+        },
+        {
+            manifest: {
+                name: "git.status",
+                description: "Return git porcelain status lines.",
+                inputSchema: emptyInputSchema,
+                outputSchema: statusOutputSchema,
+                sideEffectClass: "observe",
+                permission: "read",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "core",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute(_input, context) {
+                const { stdout } = await execFileAsync("git", ["status", "--porcelain"], { cwd: context.workingDirectory });
+                return statusOutputSchema.parse({ lines: stdout.split("\n").filter(Boolean) });
+            }
+        },
+        {
+            manifest: {
+                name: "git.diff-summary",
+                description: "Return a concise git diff stat summary.",
+                inputSchema: emptyInputSchema,
+                outputSchema: diffSummaryOutputSchema,
+                sideEffectClass: "observe",
+                permission: "read",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "core",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute(_input, context) {
+                const { stdout } = await execFileAsync("git", ["diff", "--stat", "HEAD"], { cwd: context.workingDirectory });
+                return diffSummaryOutputSchema.parse({ summary: stdout.trim() });
+            }
+        },
+        {
+            manifest: {
+                name: "shell.run-template",
+                description: "Run a pre-approved shell command template.",
+                inputSchema: runTemplateInputSchema,
+                outputSchema: runTemplateOutputSchema,
+                sideEffectClass: "observe",
+                permission: "read",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "core",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute(input, context) {
+                const parsed = runTemplateInputSchema.parse(input);
+                const template = allowedTemplates[parsed.templateId];
+                if (!template) {
+                    throw new Error(`Unknown shell template: ${parsed.templateId}`);
+                }
+                const { stdout, stderr } = await execFileAsync(template.command, template.args, { cwd: context.workingDirectory });
+                return runTemplateOutputSchema.parse({
+                    templateId: parsed.templateId,
+                    stdout,
+                    stderr
+                });
+            }
+        },
+        {
+            manifest: {
+                name: "github.create-check",
+                description: "Placeholder for GitHub check creation.",
+                inputSchema: createCheckInputSchema,
+                outputSchema: createCheckOutputSchema,
+                sideEffectClass: "apply-high-risk",
+                permission: "network",
+                defaultTimeoutMs: 2_000,
+                trust: {
+                    tier: "verified",
+                    source: "official",
+                    reviewed: true
+                }
+            },
+            async execute() {
+                return createCheckOutputSchema.parse({
+                    accepted: false,
+                    message: "GitHub integration is deferred in the initial local-only vertical slice."
+                });
+            }
+        }
+    ];
+}
+//# sourceMappingURL=builtin-adapters.js.map

package/dist/internal/builtin-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-adapters.js","sourceRoot":"","sources":["../../src/internal/builtin-adapters.ts"],"names":[],"mappings":"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"}

package/dist/internal/builtin-agents.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeAgent } from "@h9-foundry/agentforge-sdk";
+export declare function createBuiltinAgentRegistry(): Map<string, RuntimeAgent>;
+//# sourceMappingURL=builtin-agents.d.ts.map