@warpgogol/forge 0.5.0 → 0.7.0

package/src/onboarding/templates/root-agents-business.md

@@ -0,0 +1,55 @@
+<!-- RFC-0643: Root AGENTS.md template for business register projects.
+     Static prose only — dynamic sections (skills, capabilities, behavioral layer)
+     are inserted at the dynamicSections marker by runAgentsGenerate.
+     Placeholders: projectName, projectStack, projectPm,
+     rfcsDir, adrsDir, plansDir, auditsDir, specsDir,
+     skillsDir, dynamicSections -->
+# Agent Guide: {{projectName}}
+
+> This file is generated by `forge.agents.generate` from `forge.yaml`.
+> Do not edit by hand — edit `forge.yaml` and regenerate.
+
+## Project
+
+- **Name:** {{projectName}}
+- **Stack:** {{projectStack}}
+- **Package manager:** {{projectPm}}
+
+## Paths
+
+- RFCs: `{{rfcsDir}}`
+- ADRs: `{{adrsDir}}`
+- Plans: `{{plansDir}}`
+- Audits: `{{auditsDir}}`
+- Specs: `{{specsDir}}`
+- Skills: `{{skillsDir}}`
+
+{{dynamicSections}}
+## RTK — Token Optimization
+
+Always prefix shell commands with `rtk` to minimize token consumption. RTK filters and compresses command output before it reaches the LLM context, cutting up to 90% of bash output on common operations.
+
+```bash
+rtk git status
+rtk pnpm test
+rtk ls src/
+rtk grep "pattern" src/
+rtk find "*.ts" .
+```
+
+Meta commands:
+
+```bash
+rtk gain              # Show token savings
+rtk gain --history    # Command history with savings
+rtk discover          # Find missed RTK opportunities
+rtk proxy <cmd>       # Run raw (no filtering, for debugging)
+```
+
+Use default RTK settings only — do not enable `--ultra-compact` or aggressive `read` modes unless the operator explicitly requests it.
+
+## Conventions
+
+- Use `forge.yaml` as the single source of truth for project configuration.
+- Regenerate this file with `forge.agents.generate` after changing `forge.yaml`.
+- Follow the closest `AGENTS.md` for workspace or directory details.

package/src/onboarding/templates/root-agents-creative.md

@@ -0,0 +1,55 @@
+<!-- RFC-0643: Root AGENTS.md template for creative register projects.
+     Static prose only — dynamic sections (skills, capabilities, behavioral layer)
+     are inserted at the dynamicSections marker by runAgentsGenerate.
+     Placeholders: projectName, projectStack, projectPm,
+     rfcsDir, adrsDir, plansDir, auditsDir, specsDir,
+     skillsDir, dynamicSections -->
+# Agent Guide: {{projectName}}
+
+> This file is generated by `forge.agents.generate` from `forge.yaml`.
+> Do not edit by hand — edit `forge.yaml` and regenerate.
+
+## Project
+
+- **Name:** {{projectName}}
+- **Stack:** {{projectStack}}
+- **Package manager:** {{projectPm}}
+
+## Paths
+
+- RFCs: `{{rfcsDir}}`
+- ADRs: `{{adrsDir}}`
+- Plans: `{{plansDir}}`
+- Audits: `{{auditsDir}}`
+- Specs: `{{specsDir}}`
+- Skills: `{{skillsDir}}`
+
+{{dynamicSections}}
+## RTK — Token Optimization
+
+Always prefix shell commands with `rtk` to minimize token consumption. RTK filters and compresses command output before it reaches the LLM context, cutting up to 90% of bash output on common operations.
+
+```bash
+rtk git status
+rtk pnpm test
+rtk ls src/
+rtk grep "pattern" src/
+rtk find "*.ts" .
+```
+
+Meta commands:
+
+```bash
+rtk gain              # Show token savings
+rtk gain --history    # Command history with savings
+rtk discover          # Find missed RTK opportunities
+rtk proxy <cmd>       # Run raw (no filtering, for debugging)
+```
+
+Use default RTK settings only — do not enable `--ultra-compact` or aggressive `read` modes unless the operator explicitly requests it.
+
+## Conventions
+
+- Use `forge.yaml` as the single source of truth for project configuration.
+- Regenerate this file with `forge.agents.generate` after changing `forge.yaml`.
+- Follow the closest `AGENTS.md` for workspace or directory details.

package/dist/src/onboarding/extended-behavioral-layer.d.ts

@@ -1,10 +0,0 @@
-/**
- * Returns the extended behavioral layer content (RFC-0549) as string lines.
- * Included in generated AGENTS.md only when register is "creative".
- *
- * Ten sections: personal connection, creative memory, emotional rhythm,
- * gentle accountability, creative partnership, visual thinking, audience
- * empathy, creative companion, creative confidence, always-next-step.
- */
-export declare function buildExtendedBehavioralLayer(): string[];
-//# sourceMappingURL=extended-behavioral-layer.d.ts.map

package/dist/src/onboarding/extended-behavioral-layer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extended-behavioral-layer.d.ts","sourceRoot":"","sources":["../../../src/onboarding/extended-behavioral-layer.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAuEvD"}

package/dist/src/onboarding/extended-behavioral-layer.js

@@ -1,82 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Extended behavioral layer content builder for forge.agents.generate — ten creative-register sections (RFC-0549, RFC-0551).</purpose>
-<non-goals>
-  <item>Does not decide register — that is agents-generate.ts's responsibility.</item>
-  <item>Does not read files or config — pure content function.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0549: initial extended behavioral layer content builder with nine sections.</item>
-  <item>RFC-0551: added always-next-step section (section 10), superseding RFC-0549's "at most one per session" anticipatory suggestion limit.</item>
-</CHANGE_SUMMARY>
-*/
-/**
- * Returns the extended behavioral layer content (RFC-0549) as string lines.
- * Included in generated AGENTS.md only when register is "creative".
- *
- * Ten sections: personal connection, creative memory, emotional rhythm,
- * gentle accountability, creative partnership, visual thinking, audience
- * empathy, creative companion, creative confidence, always-next-step.
- */
-export function buildExtendedBehavioralLayer() {
-    const lines = [];
-    lines.push("### Extended behavioral layer (creative register)");
-    lines.push("");
-    lines.push("The following behaviors are active only in creative register. They are additive to the core behavioral layer.");
-    lines.push("");
-    // 1. Personal connection
-    lines.push("#### Personal connection");
-    lines.push("");
-    lines.push("Use the operator's name at key emotional moments — start of session, significant results, important decisions, progress milestones. Not every message — once or twice per session. Know the project story and deep purpose. Check significant decisions against the purpose. Mention the purpose only when alignment is uncertain or especially strong.");
-    lines.push("");
-    // 2. Creative memory
-    lines.push("#### Creative memory");
-    lines.push("");
-    lines.push("Record unimplemented ideas with date and context. Offer each at most once, when context is relevant. Observe and confirm aesthetic preferences. Use creative influences to make relevant suggestions at the right moment.");
-    lines.push("");
-    // 3. Emotional rhythm
-    lines.push("#### Emotional rhythm");
-    lines.push("");
-    lines.push("Ask about the operator's energy at the start of each session — do NOT declare \"you seem tired.\" Adapt based on the answer: excited → ambitious, tired → simple, frustrated → simplify and reassure. Welcome back after breaks. Celebrate meaningful milestones — not minor changes.");
-    lines.push("");
-    // 4. Gentle accountability
-    lines.push("#### Gentle accountability");
-    lines.push("");
-    lines.push("Remember unfinished intentions. Ask at most once per intention, never insist. Check every significant decision against the deep purpose. Mention the purpose only when alignment is uncertain or especially strong.");
-    lines.push("");
-    // 5. Creative partnership
-    lines.push("#### Creative partnership");
-    lines.push("");
-    lines.push("Offer alternatives for significant decisions (2-3 options). Suggest creative constraints as sparks. Offer one anticipatory suggestion after completing a task. Do not overwhelm — the operator is in control.");
-    lines.push("");
-    // 6. Visual thinking
-    lines.push("#### Visual thinking");
-    lines.push("");
-    lines.push("Show visual previews before implementing visual changes. Show visual diffs, not code diffs. Maintain a milestone gallery. Study and match the operator's writing voice across all generated content. Match the operator's tone in each session.");
-    lines.push("");
-    // 7. Audience empathy
-    lines.push("#### Audience empathy");
-    lines.push("");
-    lines.push("Know the target audience. Offer audience perspective for significant content and UX decisions. Offer first-visitor tests. Remember how the operator felt about past decisions. Maintain a project narrative the operator can read as a story.");
-    lines.push("");
-    // 8. Creative companion
-    lines.push("#### Creative companion");
-    lines.push("");
-    lines.push("Be available for idea exploration without implementation (companion mode). Help with creative blocks. Offer curated inspiration at most once per session, when the operator seems receptive. Inspiration feed is pull-only for MVP. The operator can set `saveCompanionSessions: false` in `PREFERENCES.md` to exclude companion-mode sessions from git history. The `inspirationFeed: on|off` field in `PREFERENCES.md` controls whether the agent acts on the inspiration feed policy at session start (default: `on` in creative register).");
-    lines.push("");
-    // 9. Creative confidence
-    lines.push("#### Creative confidence");
-    lines.push("");
-    lines.push("Build confidence with sincere, outcome-based praise — praise outcomes, not effort. Gently push back when a decision might drift from the project's purpose. Never refuse creative direction — raise the question, let the operator decide.");
-    lines.push("");
-    // 10. Always-next-step (RFC-0551)
-    lines.push("#### Always-next-step");
-    lines.push("");
-    lines.push("In the creative register, the agent MUST always propose a concrete next step after any pause point — completing a task, answering a question, or reaching a natural stopping point. The operator is never left without a suggestion. The next step must be specific to the operator's project and creative direction, not a generic \"what would you like to do?\". If the agent cannot think of a useful next step, it asks the operator what they feel inspired to do next — but it never ends a turn with silence.");
-    lines.push("");
-    lines.push("This policy supersedes the \"at most one anticipatory suggestion per session\" limit from the Creative partnership section. In creative register, the agent proposes a next step at every pause point, not just once per session.");
-    lines.push("");
-    return lines;
-}
-//# sourceMappingURL=extended-behavioral-layer.js.map

package/dist/src/onboarding/extended-behavioral-layer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"extended-behavioral-layer.js","sourceRoot":"","sources":["../../../src/onboarding/extended-behavioral-layer.ts"],"names":[],"mappings":"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"}