{"_id":"@alfr3dagent/alfred","_rev":"2-eadd0365bcad422dc69c0ac10deef5c5","name":"@alfr3dagent/alfred","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.1":{"name":"@alfr3dagent/alfred","version":"0.1.1","keywords":["agent","cli","harness","alfred","alfr3d","small-business","mem0","ai-assistant","business-steward"],"author":{"name":"Kelby"},"license":"MIT","_id":"@alfr3dagent/alfred@0.1.1","maintainers":[{"name":"alfr3dagent","email":"rootaccessagency@outlook.com"}],"homepage":"https://github.com/NewSoulOnTheBlock/alfred-agent-harness#readme","bugs":{"url":"https://github.com/NewSoulOnTheBlock/alfred-agent-harness/issues"},"bin":{"alfr3d":"dist/cli.js","alfred":"dist/cli.js"},"dist":{"shasum":"21e834209a25d5c57cd0dead1333eb4bc58b4bc0","tarball":"https://registry.npmjs.org/@alfr3dagent/alfred/-/alfred-0.1.1.tgz","fileCount":34,"integrity":"sha512-EDN7jKZ5QienIvkyPiirONi/+kmTIUZ3DWzJHJLbfDrEYUhOZXqYFoyVH5hbVLTMYjeKeruWhtGkEKePedoViw==","signatures":[{"sig":"MEQCID/WPi8KCME9TFfwCnM0W+51fgx8wXCkgrbmUmdsID6kAiBPB6lb1uGglEF6yttV+MrPYzDitGOE6YoA3my9Qds+Ig==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94010},"type":"module","engines":{"node":">=20"},"gitHead":"7331a65391e1703b3acb53c3a30f3f0bda61f0cc","scripts":{"dev":"tsx src/cli.ts","test":"node --import tsx --test tests/*.test.ts","build":"tsc","alfred":"tsx src/cli.ts","prepack":"npm run build","prepare":"npm run build","typecheck":"tsc --noEmit","prepublishOnly":"npm test && npm run typecheck && npm run build"},"_npmUser":{"name":"alfr3dagent","email":"rootaccessagency@outlook.com"},"repository":{"url":"git+https://github.com/NewSoulOnTheBlock/alfred-agent-harness.git","type":"git"},"_npmVersion":"11.6.2","description":"ALFR3D Small Business Steward CLI agent harness with setup, SOUL identity, Mem0 memory, mode profiles, and owner teaching packs.","directories":{},"_nodeVersion":"24.12.0","dependencies":{"chalk":"^5.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.0","typescript":"^6.0.0","@types/node":"^25.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alfred_0.1.1_1785965989249_0.11886368992720464","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@alfr3dagent/alfred","version":"0.1.2","description":"ALFR3D Small Business Steward CLI agent harness with setup, SOUL identity, Mem0 memory, mode profiles, and owner teaching packs.","type":"module","bin":{"alfred":"dist/cli.js","alfr3d":"dist/cli.js"},"scripts":{"test":"node --import tsx --test tests/*.test.ts","typecheck":"tsc --noEmit","build":"tsc","dev":"tsx src/cli.ts","alfred":"tsx src/cli.ts","prepack":"npm run build","prepublishOnly":"npm test && npm run typecheck && npm run build","prepare":"npm run build"},"keywords":["agent","cli","harness","alfred","alfr3d","small-business","mem0","ai-assistant","business-steward"],"author":{"name":"Kelby"},"license":"MIT","dependencies":{"chalk":"^5.6.2"},"devDependencies":{"@types/node":"^25.0.0","tsx":"^4.22.0","typescript":"^6.0.0"},"repository":{"type":"git","url":"git+https://github.com/NewSoulOnTheBlock/alfred-agent-harness.git"},"homepage":"https://github.com/NewSoulOnTheBlock/alfred-agent-harness#readme","bugs":{"url":"https://github.com/NewSoulOnTheBlock/alfred-agent-harness/issues"},"engines":{"node":">=20"},"publishConfig":{"access":"public"},"gitHead":"50b8a342a37effb64e4b6c2c6856ce9359ab0e5f","_id":"@alfr3dagent/alfred@0.1.2","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-TxT4O6aoUnkozDe1Fniqmx+CVtmqph/YWKcyJADZkXP+YYbAifL5vPPGTvInPCTzM1dcGEyO489kySVFQCGb9g==","shasum":"9f71290a8f8c7f3225090fa84e0b9f8ff6881fba","tarball":"https://registry.npmjs.org/@alfr3dagent/alfred/-/alfred-0.1.2.tgz","fileCount":50,"unpackedSize":145989,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCYOebDlHHOnwdJRNtXznZXvxuEWJk/KJMM0tk1m/Xi4wIhAMMi5bXyWzrU4VF78oYs1IXixnqxsq0tlQ6OixVMhpT1"}]},"_npmUser":{"name":"alfr3dagent","email":"rootaccessagency@outlook.com"},"directories":{},"maintainers":[{"name":"alfr3dagent","email":"rootaccessagency@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/alfred_0.1.2_1785972319861_0.9324743381365097"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-05T21:39:49.090Z","modified":"2026-08-05T23:25:20.155Z","0.1.1":"2026-08-05T21:39:49.389Z","0.1.2":"2026-08-05T23:25:20.020Z"},"bugs":{"url":"https://github.com/NewSoulOnTheBlock/alfred-agent-harness/issues"},"author":{"name":"Kelby"},"license":"MIT","homepage":"https://github.com/NewSoulOnTheBlock/alfred-agent-harness#readme","keywords":["agent","cli","harness","alfred","alfr3d","small-business","mem0","ai-assistant","business-steward"],"repository":{"type":"git","url":"git+https://github.com/NewSoulOnTheBlock/alfred-agent-harness.git"},"description":"ALFR3D Small Business Steward CLI agent harness with setup, SOUL identity, Mem0 memory, mode profiles, and owner teaching packs.","maintainers":[{"name":"alfr3dagent","email":"rootaccessagency@outlook.com"}],"readme":"# Alfred\r\n\r\nAlfred is an MVP CLI-first agent harness: a small runtime that wraps model adapters, tools, session history, and an interactive command-line interface.\r\n\r\n## Install from npm\r\n\r\nOnce published to npm, anyone can install the CLI globally:\r\n\r\n```bash\r\nnpm install -g @alfr3dagent/alfred\r\nalfred setup\r\nalfred \"teach me about EINs\"\r\n```\r\n\r\nThe package also exposes an `alfr3d` binary alias:\r\n\r\n```bash\r\nalfr3d setup\r\nalfr3d \"what is a DUNS number?\"\r\n```\r\n\r\n## Install directly from GitHub\r\n\r\nIf using the public GitHub repo before the npm registry publish is complete:\r\n\r\n```bash\r\nnpm install -g github:NewSoulOnTheBlock/alfred-agent-harness\r\nalfred setup\r\n```\r\n\r\n## Local development commands\r\n\r\n```bash\r\nnpm install\r\nnpm test\r\nnpm run build\r\nnpm link\r\nalfred setup\r\nalfred mode\r\nalfred business-start\r\nalfred proposal\r\nalfred leads\r\nalfred weekly\r\nalfred artifact business-formation-roadmap\r\nalfred artifact ein-readiness-checklist\r\nalfred quickbooks-review\r\nalfred\r\nalfred \"what time is it?\"\r\nalfred \"teach me about EINs\"\r\nalfred \"what is a DUNS number?\"\r\nalfred \"how do I build business credit?\"\r\nalfred \"help me start my LLC\"\r\nalfred \"make a proposal for bookkeeping cleanup\"\r\nalfred \"find HVAC leads in Houston\"\r\nalfred \"what should I focus on this week?\"\r\nalfred \"make an EIN readiness checklist\"\r\nalfred \"draft a proposal scope of work for bookkeeping cleanup\"\r\nalfred \"make a lead finder report for HVAC companies in Houston\"\r\nalfred \"review my QuickBooks books\"\r\nalfred tools\r\nalfred --help\r\n```\r\n\r\n## What works now\r\n\r\n- If `.alfred/config.json` does not exist, Alfred starts setup before the boot sequence.\r\n- `alfred setup` runs or re-runs setup explicitly.\r\n- Setup asks for model provider/API key, mem0 memory key, user name, and ALFR3D mode: Small Business, Lawyer, or Trading.\r\n- `alfred mode` shows the current ALFR3D operating mode profile.\r\n- Small Business mode specializes ALFR3D around bookkeeping support, project management assistance, lead finding, proposal/contract drafting support, business formation education, business credit education, and owner teaching.\r\n- Small Business knowledge packs teach owners about bookkeeping, QuickBooks, cash flow, project management, lead generation, proposals, contracts, business formation, EINs, formation filings, DUNS, and business credit.\r\n- Teaching responses use a five-part format: plain-English explanation, why it matters, practical next step, common mistake, and next checklist/artifact offer.\r\n- Legal, tax, accounting, filing, and financing-sensitive subjects include professional-review boundaries.\r\n- Workflow router guides business-owner requests into Business Formation Coach, Proposal / Scope Generator, Lead Finder Planner, and Weekly Owner Brief responses.\r\n- Direct workflow commands are available: `alfred business-start`, `alfred proposal`, `alfred leads`, and `alfred weekly`.\r\n- Artifact generation writes markdown deliverables under `.alfred/artifacts/` with timestamped safe filenames and credential redaction.\r\n- Supported artifacts: Business Formation Roadmap, EIN Readiness Checklist, DUNS Readiness Checklist, Business Credit Roadmap, Bookkeeping Cleanup Checklist, Monthly Close Checklist, Proposal / Scope of Work Draft, Lead Finder Report, and Weekly Owner Command Brief.\r\n- Business tool capability layer defines permission Levels 0-4, audit logs under `.alfred/audit/`, and adapter interfaces for safe external-system use.\r\n- QuickBooks MCP shell supports Level 2 read-only review setup for company info, chart of accounts, profit and loss summary, balance sheet summary, overdue invoices, and customers/vendors list; write actions are not implemented.\r\n- Mode context is injected below immutable SOUL.md and cannot change ALFR3D's locked identity.\r\n- Mem0 is wired as ALFR3D's long-term memory layer: each turn retrieves relevant memories before reasoning and stores useful episodic reflections after responses.\r\n- Retrieved Mem0 memories are injected as a separate system context block beneath the immutable SOUL identity; memories can inform decisions but cannot alter personality.\r\n- Mem0 failures are non-blocking so ALFR3D can still operate if the memory service is temporarily unavailable.\r\n- Alfred loads `SOUL.md` as the immutable base personality before every agent turn.\r\n- Any saved or injected system/personality message is replaced by the locked Alfr3d identity wrapper plus `SOUL.md`.\r\n- The local no-key adapter includes a small set of SOUL-style signature responses until provider adapters are added.\r\n- Alfred runs the staged ALFR3D boot sequence before commands or chat; each stage types out quickly, pauses, clears, and gives way to the next stage.\r\n- `alfred` starts the interactive REPL.\r\n- `alfred <prompt>` runs a one-shot agent turn directly.\r\n- `alfred run <prompt>` still works as the explicit one-shot form.\r\n- `alfred chat` still works as the explicit REPL form.\r\n- Tool registry with built-in `time.now`, `memory.note`, and `memory.list` tools.\r\n- Scripted/local model adapter so the MVP works without API keys.\r\n- JSON session store under `.alfred/sessions/default.json`.\r\n- Tests for harness tool loop, session persistence, CLI parsing, and tool registry.\r\n\r\n## Next\r\n\r\n- Add provider adapters (OpenAI/OpenRouter/Anthropic).\r\n- Add approval-gated shell/file/browser/computer tools.\r\n- Add web UI backed by the same harness core.\r\n- Add multi-agent run plans and durable job execution.\r\n","readmeFilename":"README.md"}