@jadeit/forge-ai 0.0.0 → 1.2.1

package/dist/index.js

@@ -1,5 +1,171 @@
-export const ForgeAI = async () => {
-    return {};
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+const FORGE_OVERVIEW = `# Forge AI - Structured AI-Augmented Coding
+
+Forge AI is a structured methodology for AI-augmented coding built on 6 project phases.
+
+## Phase Commands
+
+| Command | Description |
+|---------|-------------|
+| /forge-1-plan | Phase 1: Planning |
+| /forge-2-design | Phase 2: Design |
+| /forge-3-build | Phase 3: Development |
+| /forge-4-test | Phase 4: Testing |
+| /forge-5-deploy | Phase 5: Deployment |
+| /forge-6-maintain | Phase 6: Maintenance |
+
+## Feature Dev Sub-Commands (Phase 3)
+
+| Command | Description |
+|---------|-------------|
+| /forge-3-build-1-discover | Understand what needs to be built |
+| /forge-3-build-2-explore | Explore relevant existing code |
+| /forge-3-build-3-clarify | Resolve ambiguities |
+| /forge-3-build-4-approach | Design/validate approach |
+| /forge-3-build-5-implement | Build the feature |
+| /forge-3-build-6-review | Quality review |
+| /forge-3-build-7-validate | Test validation |
+| /forge-3-build-8-summarise | Document accomplishments |
+
+## Utility Commands
+
+| Command | Description |
+|---------|-------------|
+| /forge-init | Initialize Forge in a new project |
+| /forge-status | Diagnose and recover from state inconsistencies |
+
+To use a command, invoke the corresponding tool below (e.g., \`forge_plan\`).
+`;
+function getPackageDir() {
+    return join(import.meta.dirname || "", "..");
+}
+function readCommandFile(filename) {
+    const packageDir = getPackageDir();
+    const filePath = join(packageDir, "commands", filename);
+    if (existsSync(filePath)) {
+        return readFileSync(filePath, "utf-8");
+    }
+    return null;
+}
+function readAgentFile(agentName) {
+    const packageDir = getPackageDir();
+    const filePath = join(packageDir, "agents", `${agentName}.md`);
+    if (existsSync(filePath)) {
+        return readFileSync(filePath, "utf-8");
+    }
+    return null;
+}
+function stripFrontmatter(content) {
+    if (content.startsWith("---")) {
+        const endIndex = content.indexOf("---", 3);
+        if (endIndex !== -1) {
+            return content.slice(endIndex + 3).trim();
+        }
+    }
+    return content;
+}
+export const ForgeAI = async ({ client }) => {
+    const injectForgeOverview = async () => {
+        try {
+            const sessionId = (await client.session.list())?.data?.[0]?.id;
+            if (sessionId) {
+                await client.session.prompt({
+                    path: { id: sessionId },
+                    body: { parts: [{ type: "text", text: FORGE_OVERVIEW }] },
+                });
+            }
+        }
+        catch {
+        }
+    };
+    const forgeTool = (name, commandFile, agentFile) => ({
+        description: `Invoke Forge ${name} - Use this to start or continue Phase ${name}`,
+        args: {},
+        async execute(_args, context) {
+            const commandContent = readCommandFile(commandFile);
+            const agentContent = readAgentFile(agentFile);
+            const content = [
+                commandContent ? `## Command\n\n${stripFrontmatter(commandContent)}` : "",
+                agentContent ? `## Agent Instructions\n\n${stripFrontmatter(agentContent)}` : "",
+            ].filter(Boolean).join("\n\n");
+            return content || `Forge ${name} activated. No content found.`;
+        },
+    });
+    const forgeSubTool = (name, commandFile, description) => ({
+        description,
+        args: {},
+        async execute() {
+            const commandContent = readCommandFile(commandFile);
+            if (commandContent) {
+                return stripFrontmatter(commandContent);
+            }
+            return `Forge ${name} activated. No content found.`;
+        },
+    });
+    return {
+        "session.created": injectForgeOverview,
+        "session.compacted": injectForgeOverview,
+        tool: {
+            forge_plan: forgeTool("Plan", "forge-1-plan.md", "plan-agent.md"),
+            forge_design: forgeTool("Design", "forge-2-design.md", "design-agent.md"),
+            forge_build: forgeTool("Build", "forge-3-build.md", "build-agent.md"),
+            forge_test: forgeTool("Test", "forge-4-test.md", "test-agent.md"),
+            forge_deploy: forgeTool("Deploy", "forge-5-deploy.md", "deploy-agent.md"),
+            forge_maintain: forgeTool("Maintain", "forge-6-maintain.md", "maintain-agent.md"),
+            forge_init: {
+                description: "Initialize Forge in current project - Creates .forge directory and state file",
+                args: {},
+                async execute(_args, context) {
+                    const { worktree, directory } = context;
+                    const targetDir = worktree || directory;
+                    const forgeDir = join(targetDir, ".forge");
+                    const stateFile = join(forgeDir, "state.yaml");
+                    const initContent = `# Forge State
+phase: planning
+phaseStatus: not_started
+features: []
+lastUpdated: ${new Date().toISOString()}
+`;
+                    try {
+                        await Bun.$ `mkdir -p ${forgeDir}`.quiet();
+                        await Bun.$ `cat > ${stateFile} ${initContent}`.quiet();
+                    }
+                    catch {
+                        return "Failed to initialize Forge. Ensure you have write permissions.";
+                    }
+                    return `Forge initialized at ${targetDir}`;
+                },
+            },
+            forge_status: {
+                description: "Show current Forge status - phase, features, and progress",
+                args: {},
+                async execute(_args, context) {
+                    const { worktree, directory } = context;
+                    const targetDir = worktree || directory;
+                    const stateFile = join(targetDir, ".forge", "state.yaml");
+                    if (!existsSync(stateFile)) {
+                        return "Forge not initialized. Run /forge-init or use forge_init tool first.";
+                    }
+                    try {
+                        const content = readFileSync(stateFile, "utf-8");
+                        return `## Forge Status\n\n${content}`;
+                    }
+                    catch {
+                        return "Failed to read Forge state.";
+                    }
+                },
+            },
+            forge_3_build_1_discover: forgeSubTool("Build-1-Discover", "forge-3-build-1-discover.md", "Phase 3 Step 1: Understand what needs to be built"),
+            forge_3_build_2_explore: forgeSubTool("Build-2-Explore", "forge-3-build-2-explore.md", "Phase 3 Step 2: Explore relevant existing code"),
+            forge_3_build_3_clarify: forgeSubTool("Build-3-Clarify", "forge-3-build-3-clarify.md", "Phase 3 Step 3: Resolve ambiguities"),
+            forge_3_build_4_approach: forgeSubTool("Build-4-Approach", "forge-3-build-4-approach.md", "Phase 3 Step 4: Design/validate approach"),
+            forge_3_build_5_implement: forgeSubTool("Build-5-Implement", "forge-3-build-5-implement.md", "Phase 3 Step 5: Build the feature"),
+            forge_3_build_6_review: forgeSubTool("Build-6-Review", "forge-3-build-6-review.md", "Phase 3 Step 6: Quality review"),
+            forge_3_build_7_validate: forgeSubTool("Build-7-Validate", "forge-3-build-7-validate.md", "Phase 3 Step 7: Test validation"),
+            forge_3_build_8_summarise: forgeSubTool("Build-8-Summarise", "forge-3-build-8-summarise.md", "Phase 3 Step 8: Document accomplishments"),
+        },
+    };
 };
 export default ForgeAI;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAW,KAAK,IAAI,EAAE;IACxC,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jadeit/forge-ai",
-  "version": "0.0.0",
+  "version": "1.2.1",
   "description": "Forge AI - Structured AI-augmented coding methodology for OpenCode",
   "main": "dist/index.js",
   "type": "module",
@@ -8,7 +8,11 @@
     ".": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "agents",
+    "commands",
+    "skills",
+    "templates"
   ],
   "scripts": {
     "build": "bun run build.ts",
@@ -32,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jadeit/forge-ai.git"
+    "url": "git+https://github.com/jadeit/forge-ai.git"
   },
   "publishConfig": {
     "access": "public"

package/skills/forge-context-loader/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: forge-context-loader
+description: Load minimum necessary context for Forge operations based on current phase
+license: MIT
+compatibility: opencode
+metadata:
+  audience: forge-users
+  workflow: phase-execution
+---
+
+# Forge Context Loader
+
+Load the **minimum context needed** for the current Forge operation, not everything the project has ever produced.
+
+## Context Loading Rules
+
+| Phase | Load These |
+|-------|-----------|
+| `forge 1:plan` | User input, existing README or project brief |
+| `forge 2:design` | All Phase 1 outputs. Existing codebase structure if applicable |
+| `forge 3:build` | Specific task doc, technology & architecture doc, relevant source files |
+| `forge 4:test` | User stories, task docs for implemented features, test results |
+| `forge 5:deploy` | Technology & architecture doc, infrastructure-related task docs |
+| `forge 6:maintain` | Specific error/incident context, relevant source files, defect history |
+
+## Context by Sub-Phase
+
+| Sub-Phase | Additional Context |
+|-----------|-------------------|
+| `3:build 1:discover` | Task document, state file |
+| `3:build 2:explore` | Affected modules from task, existing codebase |
+| `3:build 3:clarify` | Discovery findings, exploration notes |
+| `3:build 4:approach` | Task document, design decisions |
+| `3:build 5:implement` | Task document, approach plan |
+| `3:build 6:review` | Implementation, test files, lint config |
+| `3:build 7:validate` | Task document, test files, coverage reports |
+| `3:build 8:summarise` | All phase artifacts |
+
+## Usage
+
+### Loading Context for Phase 1
+```
+Read: README.md, PROJECT_SCOPE.md (if exists)
+```
+
+### Loading Context for Phase 2
+```
+Read: docs/planning/project-scope.md
+Read: docs/planning/user-stories.md
+Read: docs/planning/implementation-plan.md
+Read: docs/planning/technology-and-architecture.md
+Glob: src/**/* (codebase structure)
+```
+
+### Loading Context for Feature Dev
+```
+Read: .forge/state.yaml
+Read: docs/planning/technology-and-architecture.md
+Read: docs/design/tasks/{task-slug}.md
+Glob: {affected_modules} (from task frontmatter)
+```
+
+## Context Budget
+
+Read `.forge/config.yaml` for context_budget settings:
+```yaml
+context_budget:
+  warning_threshold: 150000  # Warn if exceeded
+  max_threshold: 180000       # Hard limit
+```
+
+### If Context Exceeds Threshold
+
+1. **Warn the user** about the exceeded context budget
+2. **Suggest trimming strategies:**
+   - Focus on most recent changes
+   - Remove boilerplate and generated files
+   - Exclude node_modules, vendor, etc.
+3. **Prioritise:**
+   - Task document over other documents
+   - Core business logic over infrastructure
+   - Tests for the specific feature over full test suite
+
+## Implementation
+
+Use Glob and Grep to identify relevant files:
+
+```bash
+# Get affected modules from task frontmatter
+# Glob those directories
+# Grep for key patterns if needed
+```
+
+## Principles
+
+1. **Minimum Viable Context** - Only load what is necessary
+2. **Lazy Loading** - Load files when needed, not upfront
+3. **Incremental** - Context grows as you progress through sub-phases
+4. **Clean State** - Reset context when starting new phases/tasks

package/skills/forge-quality-checker/SKILL.md

@@ -0,0 +1,227 @@
+---
+name: forge-quality-checker
+description: Run quality gates for Forge Phase 3 - linting, type checking, security, coverage
+license: MIT
+compatibility: opencode
+metadata:
+  audience: forge-users
+  workflow: build-phase
+---
+
+# Forge Quality Checker
+
+Run quality gates for Feature Development (Phase 3).
+
+## Quality Thresholds
+
+Read from `.forge/config.yaml`:
+```yaml
+quality:
+  test_coverage_minimum: 80
+  lint_must_pass: true
+  type_check_must_pass: true
+  security_audit_must_pass: true
+```
+
+## Quality Gate Sequence
+
+Run in this order - fail fast:
+
+```
+1. Lint Check
+   ↓ (if pass)
+2. Type Check
+   ↓ (if pass)
+3. Security Audit
+   ↓ (if pass)
+4. Tests
+   ↓ (if pass)
+5. Coverage Check
+   ↓ (if pass)
+6. AI Code Review
+```
+
+## Gate Definitions
+
+### 1. Lint Check
+
+Run the project's linter:
+```bash
+# Python
+npm run lint  # or ruff, pylint, etc.
+
+# JavaScript/TypeScript
+npm run lint
+
+# Multiple
+npm run lint && npm run lint:style
+```
+
+**Gate:** Must pass (exit code 0)
+
+### 2. Type Check
+
+Run the project's type checker:
+```bash
+# TypeScript
+npx tsc --noEmit
+
+# Python
+npm run typecheck  # or mypy, pyright
+```
+
+**Gate:** Must pass (exit code 0)
+
+### 3. Security Audit
+
+Run security checks:
+```bash
+# npm
+npm audit
+
+# pip
+pip-audit
+
+# Docker
+trivy image [image-name]
+```
+
+**Gate:** Must pass (no critical/high vulnerabilities, or all acknowledged)
+
+### 4. Tests
+
+Run the test suite:
+```bash
+npm test
+# or
+pytest
+```
+
+**Gate:** All tests must pass (no failures)
+
+### 5. Coverage Check
+
+Run tests with coverage:
+```bash
+# Jest
+npm run test:coverage
+
+# pytest
+pytest --cov=. --cov-report=term-missing
+```
+
+**Gate:** Coverage >= configured minimum (default 80%)
+
+## Tool Detection
+
+Detect available tools automatically:
+
+| File | Tool |
+|------|------|
+| `package.json` | npm, jest, eslint, tsc |
+| `pyproject.toml` | pytest, ruff, mypy |
+| `Dockerfile` | hadolint, trivy |
+| `Makefile` | make targets |
+
+## Language-Specific Guidelines
+
+### Python
+
+- Use `ruff` for linting and formatting
+- Use `mypy` or `pyright` for type checking
+- Use `pytest` for testing
+- Use `bandit` for security
+
+### JavaScript/TypeScript
+
+- Use `eslint` for linting
+- Use `typescript` (tsc) for type checking
+- Use `jest` or `vitest` for testing
+- Use `npm audit` for security
+
+### Multi-language Projects
+
+Run all applicable tools:
+```bash
+# Run all checks
+npm run lint && npm run typecheck && npm test
+ruff check .
+mypy src/
+```
+
+## AI Code Review
+
+After automated checks pass, perform AI review:
+
+### SOLID Principles Check
+
+- **S**ingle Responsibility: Does each module do one thing?
+- **O**pen/Closed: Open for extension, closed for modification?
+- **L**iskov Substitution: Can subtypes replace base types?
+- **I**nterface Segregation: Are interfaces small and focused?
+- **D**ependency Inversion: Depend on abstractions?
+
+### Design Patterns Check
+
+Are established patterns used appropriately?
+- Factory, Builder, Singleton
+- Repository, Unit of Work
+- Observer, Strategy
+
+### Error Handling Check
+
+- Are errors caught and handled appropriately?
+- Are exceptions used for exceptional cases only?
+- Is error context preserved?
+
+### Security Check (Manual)
+
+- Input validation on all user inputs
+- Authentication/authorization properly enforced
+- Secrets not logged or exposed
+- SQL injection, XSS, CSRF addressed
+
+## Reporting
+
+### Pass Report
+
+```
+Quality Gates: PASSED
+
+✓ Lint Check - No issues
+✓ Type Check - No errors
+✓ Security Audit - No vulnerabilities
+✓ Tests - 42 passed, 0 failed
+✓ Coverage - 87% (threshold: 80%)
+
+AI Code Review: PASSED
+- SOLID compliance: ✓
+- Design patterns: ✓
+- Error handling: ✓
+- Security: ✓
+
+Ready to proceed.
+```
+
+### Fail Report
+
+```
+Quality Gates: FAILED
+
+✗ Lint Check - 3 issues found
+  - src/auth.ts:45 - Unused variable 'temp'
+  - src/utils.ts:12 - Line too long (85 > 80)
+  - src/api.ts:78 - Missing semicolon
+
+Fix required before proceeding.
+```
+
+## Rework Routing
+
+| Issue Type | Route To |
+|------------|----------|
+| Lint/type errors | `forge 3:build 5:implement` |
+| Test failures | `forge 3:build 5:implement` |
+| Coverage below threshold | `forge 3:build 5:implement` |
+| Design flaw | `forge 3:build 4:approach` |
+| Security vulnerability | `forge 3:build 5:implement` (critical) or `forge 3:build 4:approach` |