Registry / ai-ml / fnin-framework

fnin-framework

library1.0.7jsnpmunverified

FNIN (Framework New Idea Node) is a Node.js-based framework for orchestrating AI agent teams specialized in software engineering phases: requirements, architecture, development, testing, and deployment. Current version 1.0.7. It detects project context (new vs legacy) and generates artifacts incrementally. Unique differentiator is automatic context detection based on existing project files (package.json, .git) and continuous pipeline where outputs feed the next agent. Still uses stub agent implementations requiring manual LLM integration.

ai-ml devops

npm install fnin-framework

package ↗

INSTALL

IMPORT

SIG · FNIN-FRAMEWORK

fnin-framework

ai-mljavascriptv1.0.7

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FNIN CLI

✓ npx fnin run "task description"

✗ npm run fnin

Package is meant to be used via npx; run command is the primary interface

package.json bin

✓ {"bin": {"fnin": "./bin/cli.js"}}

✗ {"main": "./bin/cli.js"}

bin field required for npx invocation; main is for require(), not CLI

agents (Alice, Bob, etc.)

✓ agent prompts are markdown files in agents/ directory

✗ import Alice from 'fnin-framework/agents'

Agents are configured via file system, not code imports; customize by editing .md files

Shows installation, basic task execution, file import, iterative refinement, and output location.

// Step 1: Install and link (for local dev) npm install npm link chmod +x bin/cli.js // Step 2: Run with a task fnin run "Create a user authentication endpoint" // Step 3: Run with existing requirements file fnin run "Analyze business rules from this document" -f "my-requirements.md" // Step 4: Iterative execution (appends to artifacts) fnin run "Add password reset email functionality" // Outputs are written to .fnin_output/ directory

Debug

Known issues

gotchaDefault agents are stubs: they output placeholder text. You must implement real LLM calls in src/agent.js or the pipeline will generate no useful artifacts.

fix

Edit src/agent.js to call OpenAI/Anthropic/Gemini API with this.systemPrompt and input.

affects: 1.0.x

deprecatedThe package.json references "fnin-frame" in readme but actual intended name is "fnin-framework". Verify correct package name before publishing.

fix

Use "fnin-framework" as the package name (current). The readme snippet mentions "fnin-frame" which is incorrect.

affects: 1.0.7

gotchaOutput directory .fnin_output is created in the current working directory. Running in a project root may conflict with version control or deployment. Always ensure CWD is intended.

fix

Run fnin from inside a dedicated project folder; add .fnin_output to .gitignore.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module '../src/agent'

Running from a different directory than package root or missing file in bin/cli.js path

fix

Run fnin from the project root where package.json is located, or publish correctly with npm link.

fnin: command not found

Package not installed or bin not linked globally

fix

Run 'npm link' in the package directory, or use 'npx fnin-framework run' directly.

TypeError: Cannot read properties of undefined (reading 'systemPrompt')

Agent instance used without proper initialization or missing system prompt file in agents/

fix

Ensure agents/ directory contains .md files for each agent (Alice.md, Bob.md, etc.) with valid prompts.

Upgrade

Version history

1.0.7latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

17 hits · last 30 days

node

Amazon

Google (search)

OpenAI (training)

Resources

packagefnin-framework ↗