@jterrats/open-orchestra 0.1.0 → 0.3.0

package/dist/runtime-bootstrap.js

@@ -0,0 +1,136 @@
+import { renderManagedInstructionBlock, upsertManagedInstructionBlock, } from "./instruction-blocks.js";
+import { listCommandManifest } from "./command-manifest.js";
+import { getRuntimeAdapter } from "./runtime-adapters.js";
+const BOOTSTRAP_BLOCK_ID = "runtime-bootstrap";
+const BOOTSTRAP_VERSION = "1";
+const BOOTSTRAP_SOURCE = "open-orchestra command-manifest,runtime-bootstrap";
+export function renderRuntimeBootstrap(target = "generic") {
+    const commands = listCommandManifest();
+    const content = [
+        "# Open Orchestra Runtime Bootstrap",
+        "",
+        targetNote(target),
+        "",
+        "Use Open Orchestra as the local control plane when `.agent-workflow/` exists.",
+        "The active LLM runtime is the parent agent. Do not assume automatic real subagent spawning or real provider execution.",
+        "",
+        "## Orchestra Workflow — Required for All Work",
+        "",
+        "Every piece of work — feature, bug fix, architecture decision, stack definition, PO refinement, or research spike —",
+        "MUST go through the Orchestra workflow. Do not start any work without a registered task and a running workflow.",
+        "",
+        "### Step 1 — Register the task",
+        "```",
+        'orchestra task add --id <ID> --title "<title>" --owner <role> --paths "<files>" --goal "<goal>"',
+        "```",
+        "Use the correct owner role for the type of work:",
+        "- Architecture / stack decisions → `architect`",
+        "- Product strategy / roadmap → `product_manager`",
+        "- Backlog refinement / acceptance criteria → `product_owner`",
+        "- Implementation → `developer`",
+        "- Verification / QA → `qa`",
+        "- Release / deploy → `release_manager`",
+        "",
+        "### Step 2 — Declare effort baseline",
+        "```",
+        "orchestra estimate --task <ID> --sizing <xs|s|m|l|xl> --solo-days <N> --ai-unguided-days <N>",
+        "```",
+        "",
+        "### Step 3 — Run the autonomous workflow",
+        "```",
+        "orchestra workflow run --task <ID> --gates phase",
+        "```",
+        "The workflow sequences PM → PO → Architect → Developer → QA → Release.",
+        "Gates pause at `po→architect` and `qa→release` for human review.",
+        "The architect phase requires a sizing decision before proceeding:",
+        "```",
+        'orchestra decision add --task <ID> --owner architect --title "Story sizing" \\',
+        '  --decision "<xs|s|m|l|xl> [N points]" --context "..." --consequences "..." --status accepted',
+        "```",
+        "",
+        "### Step 4 — Collaborate through the phases",
+        "Each phase routes work to the right role. Pass your comments, requirements, or context via:",
+        "- `orchestra decision add` — architecture decisions, stack choices, accepted trade-offs",
+        "- `orchestra review` — review findings from any role",
+        "- `orchestra workflow clarify` — blocking questions from developer/QA to PO or architect",
+        "- `orchestra evidence add` — artifacts, commands run, test results",
+        "",
+        "### Step 5 — Resume after gates",
+        "```",
+        "orchestra workflow run --task <ID> --resume <run-id>",
+        "```",
+        "",
+        "### Step 6 — Benchmark after completion",
+        "```",
+        "orchestra benchmark --task <ID>",
+        "```",
+        "",
+        "## Active Work",
+        "- Run `orchestra health --json`.",
+        "- Run `orchestra task list --json` and identify the active task.",
+        "- For the active task, run context, delegation, plan, skills, protocol, and workflow render commands.",
+        "",
+        "## Task Loop",
+        ...commands
+            .filter((command) => bootstrapCommandIds().has(command.id))
+            .map((command) => "- `" + command.example + "` - " + command.summary),
+        "",
+        "## Completion",
+        "- Run the project validation gate.",
+        "- Record command/file/browser evidence with `orchestra evidence add`.",
+        "- Record review outcome with `orchestra review`.",
+        "- Update task status only after evidence and review are present.",
+        "",
+        "## Command Discovery",
+        "- Use `orchestra commands manifest --json` for command metadata.",
+        "- Use `orchestra --help` for human-readable help.",
+        "",
+    ].join("\n");
+    return {
+        target,
+        content,
+        managedBlock: renderRuntimeBootstrapManagedBlock(target, content),
+    };
+}
+export function renderRuntimeBootstrapManagedBlock(target, content) {
+    return renderManagedInstructionBlock({
+        blockId: BOOTSTRAP_BLOCK_ID,
+        generator: "open-orchestra runtime bootstrap",
+        version: BOOTSTRAP_VERSION,
+        target,
+        sourceManifest: BOOTSTRAP_SOURCE,
+        content,
+    });
+}
+export function upsertRuntimeBootstrapBlock(existing, bootstrap, options = {}) {
+    return upsertManagedInstructionBlock(existing, {
+        blockId: BOOTSTRAP_BLOCK_ID,
+        generator: "open-orchestra runtime bootstrap",
+        version: BOOTSTRAP_VERSION,
+        target: bootstrap.target,
+        sourceManifest: BOOTSTRAP_SOURCE,
+        content: bootstrap.content,
+    }, options);
+}
+function bootstrapCommandIds() {
+    return new Set([
+        "health",
+        "task-list",
+        "context",
+        "delegation",
+        "plan",
+        "skills-plan",
+        "skills-render",
+        "protocol-render",
+        "workflow-render",
+        "evidence-add",
+        "review",
+        "gate",
+        "summary",
+    ]);
+}
+function targetNote(target) {
+    const adapter = getRuntimeAdapter(target);
+    return "Runtime target: " + adapter.label + ". " + adapter.guidance;
+}
+//# sourceMappingURL=runtime-bootstrap.js.map

package/dist/runtime-bootstrap.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,36 @@
+import type { AgentLesson, AgentLessonInput, Skill, SkillPlan, SkillRenderTarget, SkillValidationReport } from "./types.js";
+export declare function listSkills(): Skill[];
+export declare function planSkillsForTask(taskId: string, root?: string): Promise<SkillPlan>;
+export declare function renderSkills({ target, taskId, skillIds, root, }: {
+    target: SkillRenderTarget;
+    taskId: string | undefined;
+    skillIds: string[] | undefined;
+    root?: string;
+}): Promise<{
+    target: SkillRenderTarget;
+    taskId: string | undefined;
+    skills: Skill[];
+    sourceGroups: string[];
+    content: string;
+}>;
+export declare function readAgentLessons(root?: string): Promise<string[]>;
+export declare function readSourceOfTruth(root?: string): Promise<unknown[]>;
+export declare function validateSkills(root?: string): Promise<SkillValidationReport>;
+export declare function recordSkillPlan(plan: SkillPlan, root?: string): Promise<void>;
+export declare function recordSkillRender(rendered: {
+    target: SkillRenderTarget;
+    taskId: string | undefined;
+    skills: Skill[];
+    sourceGroups: string[];
+}, root?: string): Promise<void>;
+export declare function addAgentLesson(input: AgentLessonInput, root?: string): Promise<AgentLesson>;
+export declare function listAgentLessons(root?: string): Promise<AgentLesson[]>;
+export declare function promoteAgentLessons({ to, filter, root, }: {
+    to: "skill" | "rule" | "doc";
+    filter?: string;
+    root?: string;
+}): Promise<{
+    artifact: string;
+    lessons: AgentLesson[];
+}>;
+export declare function writeSourceOfTruth(entries: unknown[], root?: string): Promise<void>;