syncpoint-ai 0.1.0

package/dist/plugins/code/function-parser.js

@@ -0,0 +1,220 @@
+/**
+ * Function name parsing strategies for resource scope refinement.
+ *
+ * Provides language-aware function name extraction from source text,
+ * enabling function-scoped resource claims that avoid false conflicts
+ * when two agents modify different functions in the same file.
+ */
+// ── Built-in strategies ────────────────────────────────
+const TYPESCRIPT_STRATEGY = {
+    language: "typescript",
+    extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"],
+    parse(source) {
+        const results = [];
+        const lines = source.split("\n");
+        // Matches: function name(, const name = (, const name = async (, name(params) {, async name(params) {
+        const funcRe = /^\s*(?:export\s+)?(?:default\s+)?(?:async\s+)?function\s+(\w+)\s*\(|^\s*(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\(|^\s*(?:async\s+)?(\w+)\s*\([^)]*\)\s*(?::\s*[^=]+)?\s*(?:=>|\{)/;
+        // Method: name(params) { inside class/object
+        const methodRe = /^\s+(?:async\s+)?(\w+)\s*\([^)]*\)\s*(?::\s*[^=]+)?\s*\{/;
+        // Arrow: const name = (...) =>
+        const arrowRe = /^\s*(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\([^)]*\)\s*(?::\s*[^=]+)?\s*=>/;
+        let braceDepth = 0;
+        let current = null;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            if (current) {
+                braceDepth += countBraces(line);
+                if (braceDepth <= 0) {
+                    current.endLine = lineNum;
+                    results.push(current);
+                    current = null;
+                    braceDepth = 0;
+                }
+                continue;
+            }
+            const funcMatch = line.match(funcRe) || line.match(arrowRe);
+            const methodMatch = !funcMatch ? line.match(methodRe) : null;
+            const match = funcMatch || methodMatch;
+            if (match) {
+                const name = match[1] || match[2] || match[3] || "";
+                if (!name || name.startsWith("//") || name === "if" || name === "for" || name === "while" || name === "switch" || name === "catch") {
+                    // Skip control flow keywords that look like function calls
+                    continue;
+                }
+                braceDepth = countBraces(line);
+                if (braceDepth > 0) {
+                    current = { name, startLine: lineNum, endLine: lineNum };
+                }
+                else {
+                    // Single-line function (arrow without braces)
+                    results.push({ name, startLine: lineNum, endLine: lineNum });
+                }
+            }
+        }
+        // If unclosed function at EOF, close it
+        if (current) {
+            current.endLine = lines.length;
+            results.push(current);
+        }
+        return results;
+    },
+};
+const PYTHON_STRATEGY = {
+    language: "python",
+    extensions: [".py", ".pyw", ".pyi"],
+    parse(source) {
+        const results = [];
+        const lines = source.split("\n");
+        const funcRe = /^(\s*)(?:async\s+)?def\s+(\w+)\s*\(/;
+        let current = null;
+        let baseIndent = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            const match = line.match(funcRe);
+            if (match) {
+                // Close previous function
+                if (current) {
+                    current.endLine = lineNum - 1;
+                    results.push(current);
+                }
+                const indent = match[1].length;
+                baseIndent = indent;
+                current = { name: match[2], startLine: lineNum, endLine: lineNum };
+            }
+            else if (current) {
+                // A function ends when we encounter a line with equal or less indentation that is not blank
+                const trimmed = line.trimEnd();
+                if (trimmed.length > 0) {
+                    const leadingSpaces = line.match(/^(\s*)/)?.[1].length ?? 0;
+                    if (leadingSpaces <= baseIndent && !line.trimStart().startsWith("#")) {
+                        current.endLine = lineNum - 1;
+                        results.push(current);
+                        current = null;
+                    }
+                }
+            }
+        }
+        if (current) {
+            current.endLine = lines.length;
+            results.push(current);
+        }
+        return results;
+    },
+};
+const GO_STRATEGY = {
+    language: "go",
+    extensions: [".go"],
+    parse(source) {
+        const results = [];
+        const lines = source.split("\n");
+        // func name( or func (r *Type) name(
+        const funcRe = /^\s*func\s+(?:\([^)]+\)\s+)?(\w+)\s*\(/;
+        let braceDepth = 0;
+        let current = null;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            if (current) {
+                braceDepth += countBraces(line);
+                if (braceDepth <= 0) {
+                    current.endLine = lineNum;
+                    results.push(current);
+                    current = null;
+                    braceDepth = 0;
+                }
+                continue;
+            }
+            const match = line.match(funcRe);
+            if (match) {
+                braceDepth = countBraces(line);
+                if (braceDepth > 0) {
+                    current = { name: match[1], startLine: lineNum, endLine: lineNum };
+                }
+                else {
+                    results.push({ name: match[1], startLine: lineNum, endLine: lineNum });
+                }
+            }
+        }
+        if (current) {
+            current.endLine = lines.length;
+            results.push(current);
+        }
+        return results;
+    },
+};
+// ── Registry ──────────────────────────────────────────
+const _strategies = new Map();
+function registerBuiltinStrategies() {
+    if (_strategies.size > 0)
+        return;
+    for (const s of [TYPESCRIPT_STRATEGY, PYTHON_STRATEGY, GO_STRATEGY]) {
+        _strategies.set(s.language, s);
+    }
+}
+export function registerFunctionParseStrategy(strategy) {
+    _strategies.set(strategy.language, strategy);
+}
+export function getFunctionParseStrategy(language) {
+    registerBuiltinStrategies();
+    return _strategies.get(language);
+}
+export function getStrategyForExtension(ext) {
+    registerBuiltinStrategies();
+    for (const s of _strategies.values()) {
+        if (s.extensions.includes(ext))
+            return s;
+    }
+    return undefined;
+}
+export function clearFunctionParseStrategies() {
+    _strategies.clear();
+}
+/**
+ * Parse function names from source text using the strategy for the given language or extension.
+ */
+export function parseFunctions(source, languageOrExt) {
+    registerBuiltinStrategies();
+    const strategy = _strategies.get(languageOrExt) ?? getStrategyForExtension(languageOrExt);
+    if (!strategy)
+        return [];
+    return strategy.parse(source);
+}
+/**
+ * Find which function contains a given line number.
+ */
+export function findFunctionAtLine(functions, line) {
+    return functions.find(f => line >= f.startLine && line <= f.endLine);
+}
+// ── Helpers ───────────────────────────────────────────
+function countBraces(line) {
+    let count = 0;
+    let inString = null;
+    let escaped = false;
+    for (const ch of line) {
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escaped = true;
+            continue;
+        }
+        if (inString) {
+            if (ch === inString)
+                inString = null;
+            continue;
+        }
+        if (ch === "'" || ch === '"' || ch === "`") {
+            inString = ch;
+            continue;
+        }
+        if (ch === "{")
+            count++;
+        if (ch === "}")
+            count--;
+    }
+    return count;
+}
+//# sourceMappingURL=function-parser.js.map

package/dist/plugins/code/function-parser.js.map

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

package/dist/plugins/code/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * syncpoint-plugin-code — first-party plugin for file resource ownership
+ * and code patch operations.
+ *
+ * Call registerCodePlugin() once at startup to activate validators.
+ *
+ * @example
+ *   import { registerCodePlugin } from "../../plugins/code/index.js";
+ *   registerCodePlugin();
+ */
+/**
+ * Register the code plugin's validators and resource matcher with the core registries.
+ * Safe to call multiple times — subsequent calls are no-ops (each registry check prevents duplicates).
+ */
+export declare function registerCodePlugin(): void;
+/**
+ * Check if the code plugin has been registered.
+ * Uses the resource matcher registry as source of truth.
+ */
+export declare function isCodePluginRegistered(): boolean;
+export { parseClaimPaths, pathsOverlap, filePathsToResourceRefs, resourceRefsToFilePaths, } from "./file-resource.js";
+export { extractTouchedFiles, isValidPatchFormat, findUncoveredFiles, findConflictingClaims, runCodePatchChecks, } from "./code-patch.js";
+export type { CodePatchCheckItem, CodePatchCheckResult, } from "./code-patch.js";
+export { codePatchFormatValidator, codePatchClaimCoverageValidator, codePatchNoHardConflictValidator, CODE_PLUGIN_VALIDATORS, } from "./validators.js";
+export { fileForbiddenEvaluator, moduleForbiddenEvaluator, CODE_PLUGIN_CONSTRAINT_EVALUATORS, prefixFindOverlaps, } from "./constraint-evaluators.js";
+export { parseFunctions, findFunctionAtLine, registerFunctionParseStrategy, getFunctionParseStrategy, getStrategyForExtension, clearFunctionParseStrategies, } from "./function-parser.js";
+export type { ParsedFunction, FunctionParseStrategy, } from "./function-parser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../_build/src/plugins/code/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAkCzC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAKD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/plugins/code/index.js

@@ -0,0 +1,68 @@
+/**
+ * syncpoint-plugin-code — first-party plugin for file resource ownership
+ * and code patch operations.
+ *
+ * Call registerCodePlugin() once at startup to activate validators.
+ *
+ * @example
+ *   import { registerCodePlugin } from "../../plugins/code/index.js";
+ *   registerCodePlugin();
+ */
+import { getValidatorsForOperation, registerOperationValidator, registerResourceMatcher, getResourceMatcher, registerConstraintEvaluator, getConstraintEvaluator, registerScopeMatcher, getScopeMatcher, } from "../../core/index.js";
+import { CODE_PLUGIN_VALIDATORS } from "./validators.js";
+import { pathsOverlap } from "./file-resource.js";
+import { CODE_PLUGIN_CONSTRAINT_EVALUATORS, prefixFindOverlaps } from "./constraint-evaluators.js";
+// ── Plugin registration ─────────────────────────────
+/**
+ * Register the code plugin's validators and resource matcher with the core registries.
+ * Safe to call multiple times — subsequent calls are no-ops (each registry check prevents duplicates).
+ */
+export function registerCodePlugin() {
+    // Register file ResourceMatcher (prefix/directory/glob overlap)
+    if (!getResourceMatcher("file")) {
+        registerResourceMatcher({
+            type: "file",
+            locatorsOverlap: pathsOverlap,
+        });
+    }
+    // Register OperationValidators for code_patch + file
+    const registeredNames = new Set(getValidatorsForOperation("code_patch", ["file"]).map(v => v.name));
+    for (const v of CODE_PLUGIN_VALIDATORS) {
+        if (!registeredNames.has(v.name)) {
+            registerOperationValidator(v);
+            registeredNames.add(v.name);
+        }
+    }
+    // Register ConstraintRuleEvaluators (file_forbidden, module_forbidden)
+    for (const e of CODE_PLUGIN_CONSTRAINT_EVALUATORS) {
+        if (!getConstraintEvaluator(e.ruleType)) {
+            registerConstraintEvaluator(e);
+        }
+    }
+    // Register ScopeMatchers for files and modules
+    if (!getScopeMatcher("files")) {
+        registerScopeMatcher({ field: "files", findOverlaps: prefixFindOverlaps, resourceTypes: ["file"] });
+    }
+    if (!getScopeMatcher("modules")) {
+        registerScopeMatcher({ field: "modules", findOverlaps: prefixFindOverlaps, resourceTypes: ["file"] });
+    }
+}
+/**
+ * Check if the code plugin has been registered.
+ * Uses the resource matcher registry as source of truth.
+ */
+export function isCodePluginRegistered() {
+    return getResourceMatcher("file") !== undefined;
+}
+// ── Re-exports ──────────────────────────────────────
+// File resource helpers
+export { parseClaimPaths, pathsOverlap, filePathsToResourceRefs, resourceRefsToFilePaths, } from "./file-resource.js";
+// Code patch helpers
+export { extractTouchedFiles, isValidPatchFormat, findUncoveredFiles, findConflictingClaims, runCodePatchChecks, } from "./code-patch.js";
+// Validators
+export { codePatchFormatValidator, codePatchClaimCoverageValidator, codePatchNoHardConflictValidator, CODE_PLUGIN_VALIDATORS, } from "./validators.js";
+// Constraint evaluators
+export { fileForbiddenEvaluator, moduleForbiddenEvaluator, CODE_PLUGIN_CONSTRAINT_EVALUATORS, prefixFindOverlaps, } from "./constraint-evaluators.js";
+// ── Function parser (moved from kernel — optional code analysis) ──
+export { parseFunctions, findFunctionAtLine, registerFunctionParseStrategy, getFunctionParseStrategy, getStrategyForExtension, clearFunctionParseStrategies, } from "./function-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/code/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../_build/src/plugins/code/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEnG,uDAAuD;AAEvD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,gEAAgE;IAChE,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,uBAAuB,CAAC;YACtB,IAAI,EAAE,MAAM;YACZ,eAAe,EAAE,YAAY;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,yBAAyB,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACnE,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,sBAAsB,EAAE,CAAC;QACvC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,0BAA0B,CAAC,CAAC,CAAC,CAAC;YAC9B,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,KAAK,MAAM,CAAC,IAAI,iCAAiC,EAAE,CAAC;QAClD,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,2BAA2B,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,oBAAoB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;AAClD,CAAC;AAED,uDAAuD;AAEvD,wBAAwB;AACxB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,qBAAqB;AACrB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAMzB,aAAa;AACb,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,wBAAwB;AACxB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAEpC,qEAAqE;AACrE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}

package/dist/plugins/code/validators.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Code plugin validators — OperationValidators for file resources
+ * and code_patch operations.
+ *
+ * Registered via registerCodePlugin() to hook into the generic
+ * operation validation pipeline in syncpoint-core.
+ */
+import type { OperationValidator } from "../../core/index.js";
+/**
+ * Validates that a code_patch payload is a valid unified diff format.
+ */
+export declare const codePatchFormatValidator: OperationValidator;
+/**
+ * Validates that all files touched by a code_patch are covered
+ * by the actor's active file claims.
+ */
+export declare const codePatchClaimCoverageValidator: OperationValidator;
+/**
+ * Validates that no other agent's exclusive file claims conflict
+ * with the files touched by this code_patch.
+ */
+export declare const codePatchNoHardConflictValidator: OperationValidator;
+/**
+ * All code plugin validators.
+ */
+export declare const CODE_PLUGIN_VALIDATORS: OperationValidator[];
+//# sourceMappingURL=validators.d.ts.map

package/dist/plugins/code/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../_build/src/plugins/code/validators.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAiE,MAAM,qBAAqB,CAAC;AAK7H;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,kBAetC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,kBA2B7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,kBA+B9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,EAItD,CAAC"}

package/dist/plugins/code/validators.js

@@ -0,0 +1,95 @@
+/**
+ * Code plugin validators — OperationValidators for file resources
+ * and code_patch operations.
+ *
+ * Registered via registerCodePlugin() to hook into the generic
+ * operation validation pipeline in syncpoint-core.
+ */
+import { isValidPatchFormat, findUncoveredFiles, findConflictingClaims } from "./code-patch.js";
+// ── Validators ──────────────────────────────────────
+/**
+ * Validates that a code_patch payload is a valid unified diff format.
+ */
+export const codePatchFormatValidator = {
+    name: "code_patch_format",
+    operationTypes: ["code_patch"],
+    resourceTypes: ["file"],
+    validate(ctx) {
+        const payload = ctx.payload ?? "";
+        const valid = payload.length > 0 ? isValidPatchFormat(payload) : true;
+        return [{
+                check: "code_patch_format",
+                passed: valid,
+                detail: valid
+                    ? "Patch format is valid unified diff"
+                    : "Patch does not appear to be a valid unified diff",
+            }];
+    },
+};
+/**
+ * Validates that all files touched by a code_patch are covered
+ * by the actor's active file claims.
+ */
+export const codePatchClaimCoverageValidator = {
+    name: "code_patch_claim_coverage",
+    operationTypes: ["code_patch"],
+    resourceTypes: ["file"],
+    validate(ctx) {
+        const touchedFiles = ctx.operation.targetResources
+            .filter(r => r.type === "file")
+            .map(r => r.locator);
+        if (touchedFiles.length === 0) {
+            return [{
+                    check: "code_patch_claim_coverage",
+                    passed: true,
+                    detail: "No file resources to check coverage for",
+                }];
+        }
+        const uncovered = findUncoveredFiles(touchedFiles, ctx.actorClaims);
+        return [{
+                check: "code_patch_claim_coverage",
+                passed: uncovered.length === 0,
+                detail: uncovered.length === 0
+                    ? "All touched files are covered by agent's active claims"
+                    : `Uncovered files: ${uncovered.join(", ")}`,
+            }];
+    },
+};
+/**
+ * Validates that no other agent's exclusive file claims conflict
+ * with the files touched by this code_patch.
+ */
+export const codePatchNoHardConflictValidator = {
+    name: "code_patch_no_hard_conflict",
+    operationTypes: ["code_patch"],
+    resourceTypes: ["file"],
+    validate(ctx) {
+        const touchedFiles = ctx.operation.targetResources
+            .filter(r => r.type === "file")
+            .map(r => r.locator);
+        if (touchedFiles.length === 0) {
+            return [{
+                    check: "code_patch_no_hard_conflict",
+                    passed: true,
+                    detail: "No file resources to check conflicts for",
+                }];
+        }
+        const conflicting = findConflictingClaims(touchedFiles, ctx.operation.actorId, ctx.allActiveClaims);
+        return [{
+                check: "code_patch_no_hard_conflict",
+                passed: conflicting.length === 0,
+                detail: conflicting.length === 0
+                    ? "No hard conflicts with other agents' exclusive claims"
+                    : `Conflicts with ${conflicting.length} claim(s): ${conflicting.map(c => c.id).join(", ")}`,
+            }];
+    },
+};
+/**
+ * All code plugin validators.
+ */
+export const CODE_PLUGIN_VALIDATORS = [
+    codePatchFormatValidator,
+    codePatchClaimCoverageValidator,
+    codePatchNoHardConflictValidator,
+];
+//# sourceMappingURL=validators.js.map

package/dist/plugins/code/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../../_build/src/plugins/code/validators.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEhG,uDAAuD;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAuB;IAC1D,IAAI,EAAE,mBAAmB;IACzB,cAAc,EAAE,CAAC,YAAY,CAAC;IAC9B,aAAa,EAAE,CAAC,MAAM,CAAC;IACvB,QAAQ,CAAC,GAA+B;QACtC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,OAAO,CAAC;gBACN,KAAK,EAAE,mBAAmB;gBAC1B,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,KAAK;oBACX,CAAC,CAAC,oCAAoC;oBACtC,CAAC,CAAC,kDAAkD;aACvD,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAuB;IACjE,IAAI,EAAE,2BAA2B;IACjC,cAAc,EAAE,CAAC,YAAY,CAAC;IAC9B,aAAa,EAAE,CAAC,MAAM,CAAC;IACvB,QAAQ,CAAC,GAA+B;QACtC,MAAM,YAAY,GAAG,GAAG,CAAC,SAAS,CAAC,eAAe;aAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEvB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC;oBACN,KAAK,EAAE,2BAA2B;oBAClC,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,yCAAyC;iBAClD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,EAAE,GAAG,CAAC,WAA8B,CAAC,CAAC;QAEvF,OAAO,CAAC;gBACN,KAAK,EAAE,2BAA2B;gBAClC,MAAM,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;gBAC9B,MAAM,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;oBAC5B,CAAC,CAAC,wDAAwD;oBAC1D,CAAC,CAAC,oBAAoB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC/C,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAuB;IAClE,IAAI,EAAE,6BAA6B;IACnC,cAAc,EAAE,CAAC,YAAY,CAAC;IAC9B,aAAa,EAAE,CAAC,MAAM,CAAC;IACvB,QAAQ,CAAC,GAA+B;QACtC,MAAM,YAAY,GAAG,GAAG,CAAC,SAAS,CAAC,eAAe;aAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEvB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC;oBACN,KAAK,EAAE,6BAA6B;oBACpC,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,0CAA0C;iBACnD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,qBAAqB,CACvC,YAAY,EACZ,GAAG,CAAC,SAAS,CAAC,OAAO,EACrB,GAAG,CAAC,eAAkC,CACvC,CAAC;QAEF,OAAO,CAAC;gBACN,KAAK,EAAE,6BAA6B;gBACpC,MAAM,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;gBAChC,MAAM,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;oBAC9B,CAAC,CAAC,uDAAuD;oBACzD,CAAC,CAAC,kBAAkB,WAAW,CAAC,MAAM,cAAc,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC9F,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IAC1D,wBAAwB;IACxB,+BAA+B;IAC/B,gCAAgC;CACjC,CAAC"}

package/dist/plugins/generic-agent/constraint-evaluators.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ConstraintRuleEvaluator for generic resource types.
+ *
+ * Provides "resource_forbidden" — blocks operations touching resources
+ * that match a hard_constraint scope.
+ */
+import type { ConstraintEvaluator } from "../../core/index.js";
+/**
+ * resource_forbidden — evaluates hard_constraints with scope.resources
+ * against touched resources. Blocks when any touched resource locator
+ * overlaps with the forbidden resource patterns.
+ *
+ * Scope format expected:
+ *   { "resources": ["artifact://landing-page", "binary://brand-logo.png"] }
+ */
+export declare const resourceForbiddenEvaluator: ConstraintEvaluator;
+//# sourceMappingURL=constraint-evaluators.d.ts.map

package/dist/plugins/generic-agent/constraint-evaluators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-evaluators.d.ts","sourceRoot":"","sources":["../../../_build/src/plugins/generic-agent/constraint-evaluators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAwC,MAAM,qBAAqB,CAAC;AAIrG;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,mBA2BxC,CAAC"}

package/dist/plugins/generic-agent/constraint-evaluators.js

@@ -0,0 +1,37 @@
+/**
+ * ConstraintRuleEvaluator for generic resource types.
+ *
+ * Provides "resource_forbidden" — blocks operations touching resources
+ * that match a hard_constraint scope.
+ */
+import { locatorPathsOverlap } from "./locator.js";
+/**
+ * resource_forbidden — evaluates hard_constraints with scope.resources
+ * against touched resources. Blocks when any touched resource locator
+ * overlaps with the forbidden resource patterns.
+ *
+ * Scope format expected:
+ *   { "resources": ["artifact://landing-page", "binary://brand-logo.png"] }
+ */
+export const resourceForbiddenEvaluator = {
+    ruleType: "resource_forbidden",
+    evaluate(input, item, spec) {
+        const locators = (input.touchedResources ?? []).map(r => r.locator);
+        if (!locators.length)
+            return null;
+        const forbidden = item.scope?.resources ?? [];
+        if (!forbidden.length)
+            return null;
+        const overlaps = locators.filter(loc => forbidden.some(pat => locatorPathsOverlap(loc, pat)));
+        if (overlaps.length === 0)
+            return null;
+        return {
+            rule: "resource_forbidden",
+            sourceMemoryId: item.source.sourceMemoryId,
+            projectionId: input.projection.projectionId,
+            message: spec.message ?? `Touches forbidden resources: ${overlaps.join(", ")}`,
+            evidence: overlaps,
+        };
+    },
+};
+//# sourceMappingURL=constraint-evaluators.js.map

package/dist/plugins/generic-agent/constraint-evaluators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-evaluators.js","sourceRoot":"","sources":["../../../_build/src/plugins/generic-agent/constraint-evaluators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAwB;IAC7D,QAAQ,EAAE,oBAAoB;IAC9B,QAAQ,CACN,KAAsB,EACtB,IAAyB,EACzB,IAAwB;QAExB,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAElC,MAAM,SAAS,GAAc,IAAI,CAAC,KAA8C,EAAE,SAAS,IAAI,EAAE,CAAC;QAClG,IAAI,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CACrD,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEvC,OAAO;YACL,IAAI,EAAE,oBAAoB;YAC1B,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,YAAY;YAC3C,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,gCAAgC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC9E,QAAQ,EAAE,QAAQ;SACnB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/plugins/generic-agent/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * syncpoint-plugin-generic-agent — plugin for generic (non-code) resource
+ * ownership, operation validation, and constraint enforcement.
+ *
+ * Call registerGenericAgentPlugin() once at startup to activate:
+ *   - ResourceMatchers for artifact, binary_asset, document, design_asset, dataset_slice
+ *   - OperationValidators for artifact_update, artifact_review, artifact_transform, asset_generate, asset_edit
+ *   - ConstraintRuleEvaluator for resource_forbidden
+ *   - ScopeMatchers for "resources" and "assetTypes" appliesTo fields
+ *
+ * @example
+ *   import { registerGenericAgentPlugin } from "../../plugins/generic-agent/index.js";
+ *   registerGenericAgentPlugin();
+ */
+/**
+ * Register the generic agent plugin with the core registries.
+ * Safe to call multiple times — subsequent calls are no-ops (each registry check prevents duplicates).
+ */
+export declare function registerGenericAgentPlugin(): void;
+/**
+ * Check if the generic agent plugin has been registered.
+ * Uses the resource matcher registry as source of truth.
+ */
+export declare function isGenericAgentPluginRegistered(): boolean;
+export { parseLocator, locatorPath, locatorScheme, locatorPathsOverlap, } from "./locator.js";
+export type { ParsedLocator } from "./locator.js";
+export { GENERIC_RESOURCE_TYPES } from "./resource-types.js";
+export type { GenericResourceType } from "./resource-types.js";
+export { GENERIC_OPERATION_TYPES } from "./operation-types.js";
+export type { GenericOperationType } from "./operation-types.js";
+export { GENERIC_RESOURCE_MATCHERS } from "./matchers.js";
+export { GENERIC_VALIDATORS, genericClaimCoverageValidator, genericNoHardConflictValidator, genericPayloadPresentValidator, } from "./validators.js";
+export { resourceForbiddenEvaluator } from "./constraint-evaluators.js";
+export { resourcesScopeMatcher, assetTypesScopeMatcher } from "./scope-matchers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/generic-agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../_build/src/plugins/generic-agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAsCjD;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAKD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}