forgesmith 0.2.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +40 -42
  3. package/dist/index.cjs +2975 -4
  4. package/dist/index.d.cts +821 -1
  5. package/dist/index.d.ts +821 -1
  6. package/dist/index.mjs +2870 -6
  7. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,39 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.6.0 — Scheduler, Exporters, Launch Polish
4
+
5
+ - **`schedule.ts`** — `ScheduledEntry` type + CRUD helpers (`buildScheduledEntry`, `applyEntryPatch`, `entryInRange`, `next7DaysRange`, `cascadingScheduledFor`)
6
+ - **`exporters.ts`** — `exportToBufferCsv`, `exportToHypefuryCsv`, `exportToICalendar` (RFC 5545), `previewExport`
7
+ - **`ForgeStorage`** interface extended with 4 schedule CRUD methods (`saveScheduledEntry`, `listScheduledEntries`, `updateScheduledEntry`, `deleteScheduledEntry`)
8
+ - **engine.test.ts** bugfix: mock now stubs all 36 ForgeStorage methods (brand kit, widget, style, dispatch, asset version, schedule)
9
+ - **Smell-test clean**: renamed `atlas_walkthrough` → `platform_walkthrough` in `ForgeTemplateKind` union and `distill.ts`; stripped all "Atlas" references from source comments
10
+ - **315 tests passing** (33 new in schedule + exporters suite)
11
+
12
+ ## 0.5.0 — Blueprint Reader, Prism Context, Asset Versioning, Refine
13
+
14
+ - **`blueprintReader.ts`** — reads `.prism/blueprint.json`, derives context summary, resolves zones
15
+ - **`prismContext.ts`** — builds prism context prompts for release, changelog, deep-dive, summary, zone, and module focuses
16
+ - **`assetVersioning.ts`** — append-only version log (`buildVersion`, `buildRevertVersion`, `computeDiff` with LCS), `nextVersionNumber`
17
+ - **`refineAsset.ts`** — LLM-driven refine loop with secret scanning, XML marker parsing (`<REFINED_CONTENT>` / `<REPLY>`), 8 preset suggestions
18
+
19
+ ## 0.4.0 — Forge engine + multi-channel asset dispatch
20
+
21
+ - `orchestrateDispatch` — multi-channel dispatch: one Ask → N channel outputs in parallel
22
+ - 9 bundled channels: twitter, linkedin, blog, newsletter, hn, instagram, reddit, email, slack
23
+ - Format-aware generation, brand/audience context, per-channel token budgets
24
+ - `DispatchRun`, `ChannelOutput`, `OrchestrationInput`, `OrchestrationResult` types
25
+
26
+ ## 0.3.0 — Ask-Driven Asset Generation
27
+
28
+ - `generateAskDrivenAsset(blueprint, question, opts, provider)` — generate any content format from a natural-language question about your codebase architecture
29
+ - Formats: `markdown` | `blog` | `social` | `email` | `slack` | `slide`
30
+ - Tones: `professional` | `casual` | `technical` | `executive`
31
+ - Grounded in Blueprint dependency graph (top files by usage, edge sample, category breakdown)
32
+ - Format-aware token budgets (512 for social/slack, 3072 for blog/markdown, 2048 for slides)
33
+ - Use-cases: blog posts, tweets, investor-update bullets, Slack status, slide decks
34
+ - New exported types: `AskDrivenAssetOpts`, `AskDrivenAssetFormat`
35
+ - 52 unit tests, all green (+8 new)
36
+
3
37
  ## 0.2.0 — Architecture Narrative Generators
4
38
 
5
39
  - `generateArchitectureWalkthrough(blueprint, opts, provider)` — long-form narrative explaining structure, key files, and important relationships. Tones: `technical` | `casual` | `onboarding`
package/README.md CHANGED
@@ -1,12 +1,23 @@
1
1
  # forgesmith
2
2
 
3
- Content & asset-generation engine for code intelligence.
3
+ **Content & asset-generation engine for developer teams.**
4
4
 
5
- Forge release notes, blog posts, and social copy from [prism0x2A](https://github.com/dadenjo/prism0x2A) data.
5
+ Forge release notes, walkthroughs, onboarding docs, social copy, and marketing content from [prism0x2A](https://github.com/dadenjo/prism0x2A) codebase intelligence.
6
6
 
7
- ## Status
7
+ ## What it generates (v0.6.0)
8
8
 
9
- **Phase 1** — release-notes generator. More asset-types coming in Phase 2.
9
+ | Generator | Description |
10
+ |-----------|-------------|
11
+ | Release Notes | Commit-range → structured release notes |
12
+ | Architecture Walkthrough | Blueprint → long-form walkthrough |
13
+ | Changes Since | Diff summary for any git range |
14
+ | Onboarding Doc | Blueprint → new-hire onboarding guide |
15
+ | Refactoring Report | Blueprint → refactor opportunity report |
16
+ | Ask-Driven Asset | Natural-language question → 6 content formats |
17
+ | Multi-Channel Dispatch | One ask → N parallel channel outputs |
18
+ | Asset Versioning | Append-only version history + LCS diff |
19
+ | Refine | LLM-driven iterative content refinement |
20
+ | Scheduler | Schedule entries + export (Buffer CSV, Hypefury, iCal) |
10
21
 
11
22
  ## Install
12
23
 
@@ -14,54 +25,41 @@ Forge release notes, blog posts, and social copy from [prism0x2A](https://github
14
25
  npm install forgesmith
15
26
  ```
16
27
 
17
- ## Use
28
+ ## Usage
18
29
 
19
30
  ```ts
20
- import { generateReleaseNotes, readPrismDirectory } from 'forgesmith'
21
- import { DirectLlmProvider } from 'forgesmith/providers'
22
-
23
- const data = await readPrismDirectory('./my-project/.prism')
24
- const provider = new DirectLlmProvider({ apiKey: process.env.ANTHROPIC_KEY })
25
- const result = await generateReleaseNotes(data, { tone: 'professional' }, provider)
26
- console.log(result.text)
27
- ```
28
-
29
- ## API
30
-
31
- ### `generateReleaseNotes(data, opts, provider)`
32
-
33
- Generates release notes from prism data.
34
-
35
- - `data: PrismData` — sessions, recommendations, insights from prism0x2A
36
- - `opts: ReleaseNotesOpts` — `tone`, `length`, `format`
37
- - `provider: LlmProvider` — any compatible LLM provider
38
-
39
- ### `readPrismDirectory(prismPath)`
40
-
41
- Reads a `.prism/` folder and returns a `PrismData` object.
42
-
43
- ### `DirectLlmProvider`
44
-
45
- Anthropic SDK-backed provider. Import from `forgesmith/providers`.
46
-
47
- ```ts
48
- import { DirectLlmProvider } from 'forgesmith/providers'
49
- const provider = new DirectLlmProvider({ apiKey: '...', model: 'claude-sonnet-4-6' })
31
+ import {
32
+ buildScheduledEntry,
33
+ exportToBufferCsv,
34
+ exportToICalendar,
35
+ orchestrateDispatch,
36
+ buildVersion,
37
+ refineAsset,
38
+ } from "forgesmith";
39
+ import { DirectLlmProvider } from "forgesmith/providers";
50
40
  ```
51
41
 
52
42
  ## Architecture
53
43
 
54
44
  ```
55
- prismlens (observes code)
45
+ prismlens (engine — observes code)
56
46
  ↓
57
- prism0x2A (dashboard — persists .prism/ data)
47
+ prism0x2A (dashboard — discovers & understands)
58
48
  ↓
59
- forgesmith (this — forges assets from data)
49
+ forgesmith (this — content/asset-generation engine)
60
50
  ↓
61
- forge0x2B (dashboard for marketing/comms)
51
+ forge0x2B (content/comms dashboard)
62
52
  ```
63
53
 
64
- ## Related
54
+ ## Ecosystem
55
+
56
+ | Package | Role |
57
+ |---|---|
58
+ | [`prismlens`](https://github.com/dadenjo/prismlens) | TS code-intelligence engine |
59
+ | [`prism0x2A`](https://github.com/dadenjo/prism0x2A) | Code-intelligence dashboard |
60
+ | [`forgesmith`](https://github.com/dadenjo/forgesmith) | Content/asset-generation engine (this) |
61
+ | [`forge0x2B`](https://github.com/dadenjo/forge0x2B) | Content/comms dashboard |
62
+
63
+ ---
65
64
 
66
- - [prism0x2A](https://www.npmjs.com/package/prism0x2a) — the intelligence layer
67
- - [forge0x2B](https://www.npmjs.com/package/forge0x2b) — the dashboard that uses this engine
65
+ *2B or not 2B.* — part of the **0x2A → 0x2B** intelligence pipeline.