@oleksandr.rudnychenko/sync_loop 0.2.5 → 0.3.2

package/dist/src/server.js

@@ -0,0 +1,265 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { existsSync, readFileSync } from "node:fs";
+import { join, dirname, resolve, posix } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { init, detectStacks } from "./init.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = join(__dirname, "template");
+function resolvePackageVersion() {
+    const candidatePaths = [
+        join(__dirname, "..", "package.json"),
+        join(__dirname, "..", "..", "package.json"),
+    ];
+    for (const candidatePath of candidatePaths) {
+        if (!existsSync(candidatePath))
+            continue;
+        const parsed = JSON.parse(readFileSync(candidatePath, "utf-8"));
+        if (parsed.version)
+            return parsed.version;
+    }
+    return "0.0.0";
+}
+const PACKAGE_JSON = { version: resolvePackageVersion() };
+const DOCS = {
+    overview: {
+        path: ".agent-loop/README.md",
+        name: "Protocol Overview",
+        description: "SyncLoop file index and framework overview",
+    },
+    "agents-md": {
+        path: "AGENTS.md",
+        name: "AGENTS.md Template",
+        description: "Root entrypoint template for AI agents - project identity, protocol, guardrails",
+    },
+    "protocol-summary": {
+        path: "protocol-summary.md",
+        name: "Protocol Summary",
+        description: "Condensed 7-stage reasoning loop overview (~50 lines)",
+    },
+    "reasoning-kernel": {
+        path: ".agent-loop/reasoning-kernel.md",
+        name: "Reasoning Kernel",
+        description: "Core 7-stage loop, transition map, context clearage, micro/macro classification",
+    },
+    feedback: {
+        path: ".agent-loop/feedback.md",
+        name: "Feedback Loop",
+        description: "Failure diagnosis, patch protocol, micro-loop, branch pruning, learning persistence",
+    },
+    "validate-env": {
+        path: ".agent-loop/validate-env.md",
+        name: "Validate Environment (Stage 1)",
+        description: "NFR gates: type safety, tests, layer integrity, complexity, debug hygiene",
+    },
+    "validate-n": {
+        path: ".agent-loop/validate-n.md",
+        name: "Validate Neighbors (Stage 2)",
+        description: "Shape compatibility, boundary integrity, bridge contracts",
+    },
+    patterns: {
+        path: ".agent-loop/patterns.md",
+        name: "Pattern Registry",
+        description: "Pattern routing index, architecture baseline, learned patterns, pruning records",
+    },
+    glossary: {
+        path: ".agent-loop/glossary.md",
+        name: "Domain Glossary",
+        description: "Canonical terminology, naming rules, deprecated aliases",
+    },
+    "code-patterns": {
+        path: ".agent-loop/patterns/code-patterns.md",
+        name: "Code Patterns (P1-P11)",
+        description: "Port/adapter, domain modules, tasks, routes, DI, config, types, error handling",
+    },
+    "testing-guide": {
+        path: ".agent-loop/patterns/testing-guide.md",
+        name: "Testing Guide (R2)",
+        description: "Test pyramid, fixtures, factories, mocks, parametrized tests, naming",
+    },
+    "refactoring-workflow": {
+        path: ".agent-loop/patterns/refactoring-workflow.md",
+        name: "Refactoring Workflow (R1)",
+        description: "4-phase checklist for safe file moves and module restructuring",
+    },
+    "api-standards": {
+        path: ".agent-loop/patterns/api-standards.md",
+        name: "API Standards (R3)",
+        description: "Boundary contracts, typed models, error envelopes, versioning strategy",
+    },
+};
+const DOC_ID_BY_PATH = {};
+for (const [id, doc] of Object.entries(DOCS)) {
+    DOC_ID_BY_PATH[doc.path] = id;
+}
+function readTemplate(relativePath) {
+    return readFileSync(join(TEMPLATE_DIR, relativePath), "utf-8");
+}
+export function pathDir(value) {
+    const dir = posix.dirname(value);
+    return dir === "." ? "" : dir;
+}
+export function splitHash(link) {
+    const idx = link.indexOf("#");
+    if (idx === -1)
+        return { pathPart: link, hash: "" };
+    return {
+        pathPart: link.slice(0, idx),
+        hash: link.slice(idx),
+    };
+}
+export function isExternalLink(link) {
+    return /^([a-z]+:|#)/i.test(link);
+}
+export function rewriteMarkdownLinks(content, transform) {
+    let inFence = false;
+    return content
+        .split("\n")
+        .map((line) => {
+        if (line.trimStart().startsWith("```")) {
+            inFence = !inFence;
+            return line;
+        }
+        if (inFence)
+            return line;
+        return line.replace(/\]\(([^)]+)\)/g, (_match, linkPath) => `](${transform(linkPath)})`);
+    })
+        .join("\n");
+}
+export function rewriteResourceLinks(content, sourcePath) {
+    return rewriteMarkdownLinks(content, (linkPath) => {
+        if (isExternalLink(linkPath))
+            return linkPath;
+        const { pathPart, hash } = splitHash(linkPath);
+        if (!pathPart)
+            return linkPath;
+        let canonical = posix.normalize(posix.join(pathDir(sourcePath) || ".", pathPart)).replace(/^\.\//, "");
+        if (canonical === ".agent-loop/patterns")
+            canonical = ".agent-loop/patterns.md";
+        if (canonical === "../AGENTS.md" || canonical === "AGENTS.md")
+            canonical = "AGENTS.md";
+        if (canonical === "../README.md")
+            return linkPath;
+        const docId = DOC_ID_BY_PATH[canonical];
+        if (!docId)
+            return linkPath;
+        return `syncloop://docs/${docId}${hash}`;
+    });
+}
+export function formatStacks(stacks) {
+    return stacks
+        .map((stack) => [
+        `\n### ${stack.name}${stack.path ? ` (${stack.path})` : ""}`,
+        `- Languages: ${stack.languages.join(", ")}`,
+        `- Frameworks: ${stack.frameworks.join(", ")}`,
+        stack.testRunner ? `- Test runner: ${stack.testRunner}` : null,
+        stack.typeChecker ? `- Type checker: ${stack.typeChecker}` : null,
+        stack.linter ? `- Linter: ${stack.linter}` : null,
+        stack.packageManager ? `- Package manager: ${stack.packageManager}` : null,
+    ].filter(Boolean).join("\n"))
+        .join("\n");
+}
+export function createServer() {
+    const server = new McpServer({
+        name: "sync_loop",
+        version: PACKAGE_JSON.version,
+    });
+    for (const [id, doc] of Object.entries(DOCS)) {
+        server.registerResource(doc.name, `syncloop://docs/${id}`, { description: doc.description, mimeType: "text/markdown" }, async (uri) => {
+            const raw = readTemplate(doc.path);
+            const rewritten = rewriteResourceLinks(raw, doc.path);
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: "text/markdown",
+                        text: rewritten,
+                    }],
+            };
+        });
+    }
+    const StackSchema = z.object({
+        name: z.string().describe("Stack/layer name (for example: backend, frontend, worker)"),
+        languages: z.array(z.string()).describe("Programming languages used by this stack"),
+        frameworks: z.array(z.string()).describe("Frameworks/libraries for this stack"),
+        testRunner: z.string().optional().describe("Test runner command"),
+        typeChecker: z.string().optional().describe("Type checker command"),
+        linter: z.string().optional().describe("Lint/format command"),
+        packageManager: z.string().optional().describe("Package manager name"),
+        path: z.string().optional().describe("Root directory of this stack relative to project root"),
+    });
+    server.registerTool("init", {
+        description: "Scaffold SyncLoop protocol files into a project. If target is not explicitly provided, default to all. If stacks are not provided, auto-detect them by scanning the repository.",
+        inputSchema: {
+            projectPath: z.string().optional().describe("Project root path. Defaults to current working directory."),
+            target: z.enum(["copilot", "cursor", "claude", "all"]).optional().default("all"),
+            stacks: z.array(StackSchema).optional().describe("Optional stack definitions. Auto-detected when omitted."),
+            dryRun: z.boolean().optional().default(false).describe("Preview file writes without modifying files."),
+            overwrite: z.boolean().optional().default(true).describe("Overwrite existing generated files."),
+        },
+    }, async ({ projectPath, target = "all", stacks, dryRun = false, overwrite = true }) => {
+        try {
+            const resolvedProjectPath = resolve(projectPath ?? process.cwd());
+            const effectiveStacks = stacks?.length ? stacks : detectStacks(resolvedProjectPath);
+            const initResult = init(resolvedProjectPath, target, effectiveStacks, { dryRun, overwrite });
+            const bootstrapPrompt = readTemplate("bootstrap-prompt.md");
+            const stackSummary = formatStacks(initResult.stacks);
+            return {
+                content: [
+                    { type: "text", text: `SyncLoop initialized for ${target}:\n\n${initResult.results.join("\n")}` },
+                    { type: "text", text: `\n---\n\n## Options\n- dryRun: ${dryRun}\n- overwrite: ${overwrite}` },
+                    { type: "text", text: `\n---\n\n## Detected stacks\n${stackSummary}` },
+                    {
+                        type: "text",
+                        text: `\n---\n\n**IMPORTANT: Now scan the codebase and wire the generated SyncLoop files to this project.**\n\n${bootstrapPrompt}`,
+                    },
+                    { type: "text", text: `\n---\n\n## Machine-readable result\n\`\`\`json\n${JSON.stringify(initResult, null, 2)}\n\`\`\`` },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error initializing SyncLoop: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.registerPrompt("bootstrap", { description: "Bootstrap prompt - wire SyncLoop protocol to an existing project by scanning its codebase" }, async () => ({
+        description: "Scan the project codebase and wire SyncLoop protocol references to real project structure",
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: readTemplate("bootstrap-prompt.md"),
+                },
+            }],
+    }));
+    server.registerPrompt("protocol", { description: "SyncLoop reasoning protocol summary - inject as system context for any AI coding task" }, async () => ({
+        description: "The SyncLoop 7-stage reasoning protocol for self-correcting agent behavior",
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: readTemplate("protocol-summary.md"),
+                },
+            }],
+    }));
+    return server;
+}
+export async function startServer() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    return server;
+}
+function isMainModule(metaUrl) {
+    const entryFile = process.argv[1];
+    if (!entryFile)
+        return false;
+    return metaUrl === pathToFileURL(entryFile).href;
+}
+if (isMainModule(import.meta.url)) {
+    await startServer();
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/template/.agent-loop/README.md

@@ -0,0 +1,75 @@
+# Agent Loop Prompts
+
+Modular prompts for AI coding agents to run a reusable, self-correcting delivery loop.
+
+Project bootstrap workflow and setup prompt are documented in [../README.md](../README.md).
+
+## Overview
+
+The framework uses a **7-stage protocol** with **2-stage validation**, **feedback integration**, and **session persistence**:
+
+```
+  ┌─────────┐     ┌─────────┐
+  │ 1 SENSE │◄───►│ 2 GKP   │  ◄── inner loop: gather + compress
+  └────┬────┘     └────┬────┘
+       └───────┬───────┘
+               ▼
+       ┌──────────────┐
+       │ 3 DECIDE+ACT │  ← select mode, plan, execute
+       └──────┬───────┘
+              ▼
+  ┌───────────────────────┐
+  │ 4 CHALLENGE-TEST      │  ◄── inner loop: validate + fix (max 5)
+  │   ├ Stage 1: ENV      │  ← NFRs (types, tests, layers)
+  │   └ Stage 2: NEIGHBOR │  ← Shapes, boundaries, bridges
+  └──────────┬────────────┘
+             │   On FAIL → FEEDBACK → patch → retry
+             ▼
+       ┌──────────┐
+       │ 5 UPDATE  │  ← commit state transitions
+       └─────┬────┘
+             ▼
+       ┌──────────┐
+       │ 6 LEARN   │  ← persist to patterns.md / patterns/ specs
+       └────┬─────┘
+            ▼
+       ┌──────────┐
+       │ 7 REPORT  │  ← store session log to docs/reports/
+       └──────────┘   (skip if trivial)
+```
+
+## Prompt Files
+
+| File | Purpose | When to Use |
+|------|---------|-------------|
+| [reasoning-kernel.md](reasoning-kernel.md) | Core 7-stage loop with integrated validation | Every turn — master orchestrator |
+| [patterns.md](patterns.md) | Pattern registry + learned fixes | GKP phase (read), LEARN phase (write) |
+| [patterns/](patterns/) | Detailed implementation specs | GKP routes here for examples |
+| [glossary.md](glossary.md) | Canonical domain terminology | Naming, resolving ambiguous terms |
+| [validate-env.md](validate-env.md) | Stage 1: NFRs (types, tests, layers, complexity) | CHALLENGE-TEST Stage 1 |
+| [validate-n.md](validate-n.md) | Stage 2: Neighbors (shapes, boundaries, bridges) | CHALLENGE-TEST Stage 2 |
+| [feedback.md](feedback.md) | Behavioral patches, learning, spec persistence | On validation failure; LEARN phase routing |
+
+## Pattern Specs (patterns/)
+
+| Spec File | Pattern IDs | Content |
+|-----------|-------------|---------|
+| [code-patterns.md](patterns/code-patterns.md) | P1–P11 | Ports, modules, tasks, routes, DI, config, types, errors |
+| [testing-guide.md](patterns/testing-guide.md) | R2 | Test patterns, fixtures, mocks, naming, 3-layer strategy |
+| [refactoring-workflow.md](patterns/refactoring-workflow.md) | R1 | 4-phase refactoring checklist |
+| [api-standards.md](patterns/api-standards.md) | R3 | Boundary contract standards, endpoint workflow |
+
+## Validation Structure
+
+Each gate follows: **CHECK → FEEDBACK (if failed) → RETRY**
+
+| Stage | File | Scope |
+|-------|------|-------|
+| Stage 1: ENV | [validate-env.md](validate-env.md) | Non-functional requirements |
+| Stage 2: NEIGHBOR | [validate-n.md](validate-n.md) | Compatibility and integration surfaces |
+| Failure flow | [feedback.md](feedback.md) | Diagnosis, patching, escalation |
+
+## Entrypoint
+
+The root entrypoint is [AGENTS.md](../AGENTS.md).
+It provides architecture rules, operational modes, and routing into this folder.