npm - project-atlas - Versions diffs - 0.1.0 - Mend

project-atlas 0.1.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 (43) hide show

package/CHANGELOG.md +30 -0
package/CONTRIBUTING.md +57 -0
package/LICENSE +21 -0
package/README.md +305 -0
package/SECURITY.md +28 -0
package/adapters/claude-code/README.md +27 -0
package/adapters/continue/README.md +16 -0
package/adapters/cursor/README.md +29 -0
package/adapters/opencode/README.md +37 -0
package/adapters/opencode/commands/kb-context.md +5 -0
package/adapters/opencode/commands/kb-refresh.md +11 -0
package/adapters/opencode/skills/project-atlas/SKILL.md +15 -0
package/adapters/opencode/tools/project_atlas_context.js +37 -0
package/adapters/opencode/tools/project_atlas_propose.js +53 -0
package/adapters/opencode/tools/project_atlas_scan.js +34 -0
package/dist/core.js +1395 -0
package/dist/frontmatter.js +103 -0
package/dist/index.js +7 -0
package/dist/mcp.js +172 -0
package/dist/scanner.js +128 -0
package/dist/types.js +1 -0
package/dist/utils.js +174 -0
package/docs/site/README.md +47 -0
package/docs/site/agent-quickstart.md +243 -0
package/docs/site/best-practices.md +87 -0
package/docs/site/en/README.md +49 -0
package/docs/site/en/agent-quickstart.md +191 -0
package/docs/site/en/quick-start.md +79 -0
package/docs/site/publish-now.md +166 -0
package/docs/site/quick-start.md +128 -0
package/docs/site/release-process.md +94 -0
package/docs/site/security-faq.md +55 -0
package/docs/site/team-rollout.md +59 -0
package/package.json +55 -0
package/schema/context-pack.schema.json +80 -0
package/schema/external-evidence.schema.json +84 -0
package/schema/manifest.schema.json +28 -0
package/schema/memory-candidate.schema.json +76 -0
package/schema/proposal.schema.json +122 -0
package/schema/trigger-result.schema.json +47 -0
package/templates/frontend-app/README.md +5 -0
package/templates/generic-service/README.md +5 -0
package/templates/java-backend/README.md +5 -0

package/schema/external-evidence.schema.json ADDED Viewed

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/liuliuyun/project-atlas/schema/external-evidence.schema.json",
+  "title": "project-atlas external evidence",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "external_evidence"],
+  "properties": {
+    "schema_version": {
+      "const": "1.0"
+    },
+    "external_evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "source_type", "path"],
+        "properties": {
+          "source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source_type": {
+            "type": "string",
+            "minLength": 1
+          },
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "locator": {
+            "type": "string"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "external_evidence_item": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "source_type", "path"],
+      "properties": {
+        "source": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source_type": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "symbol": {
+          "type": "string"
+        },
+        "summary": {
+          "type": "string"
+        },
+        "locator": {
+          "type": "string"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      }
+    }
+  }
+}

package/schema/manifest.schema.json ADDED Viewed

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/liuliuyun/project-atlas/schema/manifest.schema.json",
+  "title": "project-atlas manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "max_context_chars", "required_files", "evidence_dir"],
+  "properties": {
+    "schema_version": {
+      "const": "1.0"
+    },
+    "max_context_chars": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "required_files": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "evidence_dir": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}

package/schema/memory-candidate.schema.json ADDED Viewed

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/liuliuyun/project-atlas/schema/memory-candidate.schema.json",
+  "title": "project-atlas memory candidate",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "source_files", "memories"],
+  "properties": {
+    "schema_version": {
+      "const": "1.0"
+    },
+    "source_files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!(?:\\.git|\\.project-atlas|\\.code-review-graph)(?:[\\\\/]|$))(?!\\.\\.(?:[\\\\/]|$))(?!.*[\\\\/]\\.\\.(?:[\\\\/]|$))(?!.*[\\r\\n]).+"
+      }
+    },
+    "memories": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["target", "memory_type", "topic", "scope", "confidence", "summary", "body"],
+        "properties": {
+          "target": {
+            "type": "string",
+            "pattern": "^knowledge/(?!\\.\\.(?:/|$))(?!.*(?:/)\\.\\.(?:/|$))(?!.*[\\r\\n]).+"
+          },
+          "memory_type": {
+            "enum": ["decision", "experience", "project_fact"]
+          },
+          "topic": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^(?!.*[\\r\\n]).+$"
+          },
+          "scope": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^(?!.*[\\r\\n]).+$"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^(?!.*[\\r\\n]).+$"
+          },
+          "body": {
+            "type": "string",
+            "minLength": 1
+          },
+          "owner": {
+            "type": "string",
+            "pattern": "^(?!.*[\\r\\n]).*$"
+          },
+          "related_docs": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!(?:\\.git|\\.project-atlas|\\.code-review-graph)(?:[\\\\/]|$))(?!\\.\\.(?:[\\\\/]|$))(?!.*[\\\\/]\\.\\.(?:[\\\\/]|$))(?!.*[\\r\\n]).+"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schema/proposal.schema.json ADDED Viewed

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/liuliuyun/project-atlas/schema/proposal.schema.json",
+  "title": "project-atlas proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "proposal_id",
+    "schema_version",
+    "base_commit",
+    "worktree_diff_hash",
+    "source_files",
+    "source_hashes",
+    "target_files",
+    "operations",
+    "created_at",
+    "expires_at",
+    "reason",
+    "external_evidence",
+    "sensitive_scan_result",
+    "proposal_status",
+    "proposal_hash"
+  ],
+  "properties": {
+    "proposal_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "schema_version": {
+      "const": "1.0"
+    },
+    "base_commit": {
+      "type": "string",
+      "minLength": 1
+    },
+    "worktree_diff_hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "source_files": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "source_hashes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^sha256:([a-f0-9]{64}|missing)$"
+      }
+    },
+    "target_files": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^knowledge/"
+      }
+    },
+    "operations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "path", "content", "target_current_hash"],
+        "properties": {
+          "type": {
+            "const": "replace_file"
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^knowledge/"
+          },
+          "content": {
+            "type": "string"
+          },
+          "target_current_hash": {
+            "type": "string",
+            "pattern": "^sha256:([a-f0-9]{64}|missing)$"
+          }
+        }
+      }
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "expires_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1
+    },
+    "external_evidence": {
+      "type": "array",
+      "items": {
+        "$ref": "external-evidence.schema.json#/$defs/external_evidence_item"
+      }
+    },
+    "sensitive_scan_result": {
+      "enum": ["passed", "blocked"]
+    },
+    "proposal_status": {
+      "enum": ["proposed", "blocked_sensitive", "applied"]
+    },
+    "proposal_hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "applied_hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "applied_at": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}

package/schema/trigger-result.schema.json ADDED Viewed

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/liuliuyun/project-atlas/schema/trigger-result.schema.json",
+  "title": "project-atlas trigger result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "proposal_id",
+    "proposal_hash",
+    "worktree_diff_hash",
+    "applied_hash",
+    "needs_knowledge_update",
+    "proposal_status",
+    "updated_at"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0"
+    },
+    "proposal_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "proposal_hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "worktree_diff_hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "applied_hash": {
+      "type": "string"
+    },
+    "needs_knowledge_update": {
+      "type": "boolean"
+    },
+    "proposal_status": {
+      "enum": ["proposed", "blocked_sensitive", "applied"]
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}

package/templates/frontend-app/README.md ADDED Viewed

@@ -0,0 +1,5 @@
+# Frontend App Template
+Use this template for frontend applications.
+It keeps the default `knowledge/` structure and seeds prompts for routing, page state, API contracts, visual checks, and browser coverage.

package/templates/generic-service/README.md ADDED Viewed

@@ -0,0 +1,5 @@
+# Generic Service Template
+Use this template for a service or tool that does not yet need stack-specific knowledge prompts.
+It keeps the default `knowledge/` structure and changes only the initial section wording.

package/templates/java-backend/README.md ADDED Viewed

@@ -0,0 +1,5 @@
+# Java Backend Template
+Use this template for Java backend services.
+It keeps the default `knowledge/` structure and seeds prompts for controller, service, Feign, MQ, transaction, and release knowledge.