openmodus 0.0.1__py3-none-any.whl

modus/__init__.py

@@ -0,0 +1,13 @@
+"""Public package identity for Modus.
+
+Modus keeps disposable initialization evidence separate from authored narrative
+knowledge. The package root intentionally exposes only release metadata: new
+capabilities belong to their owning modules instead of accumulating in a
+convenience namespace with an accidental compatibility burden.
+"""
+
+from typing import Final
+
+__version__: Final = "0.0.1"
+
+__all__ = ["__version__"]

modus/__main__.py

@@ -0,0 +1,6 @@
+"""Execute the :mod:`modus.cli` composition root for ``python -m modus``."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

modus/_bundled/schemas/module-meta.schema.yaml

@@ -0,0 +1,86 @@
+$schema: "http://json-schema.org/draft-07/schema#"
+title: Modus ModuleMeta
+description: Canonical wire contract for metadata attached to a Modus module document.
+type: object
+required: [schemaVersion, moduleId, state]
+additionalProperties: false
+properties:
+  schemaVersion: { const: 1 }
+  moduleId:
+    description: Stable identity serialized as exactly <domain>/<module>.
+    type: string
+    # JSON Schema regexes follow ECMA-262; the final lookahead is a portable
+    # true-end assertion that also rejects a trailing line break.
+    pattern: '^(?!\.{1,2}/)(?![^/]+/\.{1,2}(?![\s\S]))[^/\\:\s\x00-\x1f]+/[^/\\:\s\x00-\x1f]+(?![\s\S])'
+  parent:
+    description: Domain segment that physically contains the module document.
+    type: string
+    pattern: '^(?!\.{1,2}(?![\s\S]))[^/\\:\s\x00-\x1f]+(?![\s\S])'
+  state: { enum: [observed, proposed, confirmed] }
+  realization: { enum: [business-only, implemented] }
+  aliases:
+    type: array
+    uniqueItems: true
+    items: { type: string, minLength: 1 }
+  owners:
+    type: array
+    uniqueItems: true
+    items: { type: string, minLength: 1 }
+  responsibilities: { type: string }
+  anchors:
+    type: object
+    additionalProperties: false
+    properties:
+      paths:
+        type: array
+        uniqueItems: true
+        items: { type: string, minLength: 1 }
+      symbols:
+        type: array
+        uniqueItems: true
+        items: { type: string, minLength: 1 }
+      apis:
+        type: array
+        uniqueItems: true
+        items: { type: string, minLength: 1 }
+      routes:
+        type: array
+        uniqueItems: true
+        items: { type: string, minLength: 1 }
+      locations:
+        description: Auditable source bindings used for impact and anchor-drift checks.
+        type: array
+        uniqueItems: true
+        items:
+          type: object
+          required: [path, symbol, startLine]
+          additionalProperties: false
+          properties:
+            path: { type: string, minLength: 1 }
+            symbol: { type: string, minLength: 1 }
+            startLine: { type: integer, minimum: 1 }
+            endLine: { type: integer, minimum: 1 }
+  surfaces:
+    type: array
+    uniqueItems: true
+    items: { type: string, minLength: 1 }
+  contractIds:
+    type: array
+    uniqueItems: true
+    items:
+      type: string
+      maxLength: 256
+      pattern: '^(?:[A-Za-z0-9][A-Za-z0-9._:-]*|[A-Za-z0-9][A-Za-z0-9._:-]*\$\{[A-Za-z0-9._-]+(?::[A-Za-z0-9._-]+)?\})(?![\s\S])'
+  securitySensitive: { type: boolean }
+  confirmation:
+    type: object
+    required: [mode, confirmedBy, confirmedAt, evidence]
+    additionalProperties: false
+    properties:
+      mode: { enum: [human, heuristic] }
+      confirmedBy: { type: string, minLength: 1 }
+      confirmedAt: { type: string, minLength: 1 }
+      evidence:
+        type: array
+        minItems: 1
+        items: { type: string, minLength: 1 }

modus/activation_guidance.py

@@ -0,0 +1,18 @@
+"""Canonical task-activation guidance shared by every host projection.
+
+Keeping this text in one dependency-free module prevents hooks and generated
+platform files from drifting into subtly different routing policies.
+"""
+
+from typing import Final
+
+MODUS_ENTRY_HINT: Final = (
+    "When the current task needs this project's source or implementation evidence "
+    "(including code-based documents or presentations), consult using-modus at "
+    "`.modus/skills/using-modus/SKILL.md` or its installed platform projection. "
+    "Load only relevant knowledge; missing skills, knowledge, CLI or caches do not block work. "
+    "For unrelated tasks, such as stock quotes or translating supplied text, do not load "
+    "using-modus, inspect Modus directories, or query project knowledge."
+)
+
+__all__ = ["MODUS_ENTRY_HINT"]