forgesmith 0.3.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.6.0 — Scheduler, Exporters, Launch Polish
+
+- **`schedule.ts`** — `ScheduledEntry` type + CRUD helpers (`buildScheduledEntry`, `applyEntryPatch`, `entryInRange`, `next7DaysRange`, `cascadingScheduledFor`)
+- **`exporters.ts`** — `exportToBufferCsv`, `exportToHypefuryCsv`, `exportToICalendar` (RFC 5545), `previewExport`
+- **`ForgeStorage`** interface extended with 4 schedule CRUD methods (`saveScheduledEntry`, `listScheduledEntries`, `updateScheduledEntry`, `deleteScheduledEntry`)
+- **engine.test.ts** bugfix: mock now stubs all 36 ForgeStorage methods (brand kit, widget, style, dispatch, asset version, schedule)
+- **Smell-test clean**: renamed `atlas_walkthrough` → `platform_walkthrough` in `ForgeTemplateKind` union and `distill.ts`; stripped all "Atlas" references from source comments
+- **315 tests passing** (33 new in schedule + exporters suite)
+
+## 0.5.0 — Blueprint Reader, Prism Context, Asset Versioning, Refine
+
+- **`blueprintReader.ts`** — reads `.prism/blueprint.json`, derives context summary, resolves zones
+- **`prismContext.ts`** — builds prism context prompts for release, changelog, deep-dive, summary, zone, and module focuses
+- **`assetVersioning.ts`** — append-only version log (`buildVersion`, `buildRevertVersion`, `computeDiff` with LCS), `nextVersionNumber`
+- **`refineAsset.ts`** — LLM-driven refine loop with secret scanning, XML marker parsing (`<REFINED_CONTENT>` / `<REPLY>`), 8 preset suggestions
+
+## 0.4.0 — Forge engine + multi-channel asset dispatch
+
+- `orchestrateDispatch` — multi-channel dispatch: one Ask → N channel outputs in parallel
+- 9 bundled channels: twitter, linkedin, blog, newsletter, hn, instagram, reddit, email, slack
+- Format-aware generation, brand/audience context, per-channel token budgets
+- `DispatchRun`, `ChannelOutput`, `OrchestrationInput`, `OrchestrationResult` types
+
 ## 0.3.0 — Ask-Driven Asset Generation
 
 - `generateAskDrivenAsset(blueprint, question, opts, provider)` — generate any content format from a natural-language question about your codebase architecture

package/README.md

@@ -1,12 +1,23 @@
 # forgesmith
 
-Content & asset-generation engine for code intelligence.
+**Content & asset-generation engine for developer teams.**
 
-Forge release notes, blog posts, and social copy from [prism0x2A](https://github.com/dadenjo/prism0x2A) data.
+Forge release notes, walkthroughs, onboarding docs, social copy, and marketing content from [prism0x2A](https://github.com/dadenjo/prism0x2A) codebase intelligence.
 
-## Status
+## What it generates (v0.6.0)
 
-**Phase 1** — release-notes generator. More asset-types coming in Phase 2.
+| Generator | Description |
+|-----------|-------------|
+| Release Notes | Commit-range → structured release notes |
+| Architecture Walkthrough | Blueprint → long-form walkthrough |
+| Changes Since | Diff summary for any git range |
+| Onboarding Doc | Blueprint → new-hire onboarding guide |
+| Refactoring Report | Blueprint → refactor opportunity report |
+| Ask-Driven Asset | Natural-language question → 6 content formats |
+| Multi-Channel Dispatch | One ask → N parallel channel outputs |
+| Asset Versioning | Append-only version history + LCS diff |
+| Refine | LLM-driven iterative content refinement |
+| Scheduler | Schedule entries + export (Buffer CSV, Hypefury, iCal) |
 
 ## Install
 
@@ -14,54 +25,41 @@ Forge release notes, blog posts, and social copy from [prism0x2A](https://github
 npm install forgesmith
 ```
 
-## Use
+## Usage
 
 ```ts
-import { generateReleaseNotes, readPrismDirectory } from 'forgesmith'
-import { DirectLlmProvider } from 'forgesmith/providers'
-
-const data = await readPrismDirectory('./my-project/.prism')
-const provider = new DirectLlmProvider({ apiKey: process.env.ANTHROPIC_KEY })
-const result = await generateReleaseNotes(data, { tone: 'professional' }, provider)
-console.log(result.text)
-```
-
-## API
-
-### `generateReleaseNotes(data, opts, provider)`
-
-Generates release notes from prism data.
-
-- `data: PrismData` — sessions, recommendations, insights from prism0x2A
-- `opts: ReleaseNotesOpts` — `tone`, `length`, `format`
-- `provider: LlmProvider` — any compatible LLM provider
-
-### `readPrismDirectory(prismPath)`
-
-Reads a `.prism/` folder and returns a `PrismData` object.
-
-### `DirectLlmProvider`
-
-Anthropic SDK-backed provider. Import from `forgesmith/providers`.
-
-```ts
-import { DirectLlmProvider } from 'forgesmith/providers'
-const provider = new DirectLlmProvider({ apiKey: '...', model: 'claude-sonnet-4-6' })
+import {
+  buildScheduledEntry,
+  exportToBufferCsv,
+  exportToICalendar,
+  orchestrateDispatch,
+  buildVersion,
+  refineAsset,
+} from "forgesmith";
+import { DirectLlmProvider } from "forgesmith/providers";
 ```
 
 ## Architecture
 
 ```
-prismlens   (observes code)
+prismlens    (engine — observes code)
     ↓
-prism0x2A   (dashboard — persists .prism/ data)
+prism0x2A    (dashboard — discovers & understands)
     ↓
-forgesmith  (this — forges assets from data)
+forgesmith   (this — content/asset-generation engine)
     ↓
-forge0x2B   (dashboard for marketing/comms)
+forge0x2B    (content/comms dashboard)
 ```
 
-## Related
+## Ecosystem
+
+| Package | Role |
+|---|---|
+| [`prismlens`](https://github.com/dadenjo/prismlens) | TS code-intelligence engine |
+| [`prism0x2A`](https://github.com/dadenjo/prism0x2A) | Code-intelligence dashboard |
+| [`forgesmith`](https://github.com/dadenjo/forgesmith) | Content/asset-generation engine (this) |
+| [`forge0x2B`](https://github.com/dadenjo/forge0x2B) | Content/comms dashboard |
+
+---
 
-- [prism0x2A](https://www.npmjs.com/package/prism0x2a) — the intelligence layer
-- [forge0x2B](https://www.npmjs.com/package/forge0x2b) — the dashboard that uses this engine
+*2B or not 2B.* — part of the **0x2A → 0x2B** intelligence pipeline.