coding-os 0.3.4__tar.gz → 0.3.6__tar.gz

{coding_os-0.3.4 → coding_os-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-os
-Version: 0.3.4
+Version: 0.3.6
 Summary: The cognitive operating system that gives AI agents memory, structure, and discipline
 Author-email: Kourosh Ebrahimzadeh <info@coding-os.dev>
 License-Expression: Apache-2.0
@@ -66,7 +66,7 @@ Dynamic: license-file
 
 # coding-os
 
-[![release](https://img.shields.io/github/v/release/kouroshez/coding-os?color=blue)](https://github.com/kouroshez/coding-os/releases)
+[![PyPI](https://img.shields.io/pypi/v/coding-os?color=blue&label=pypi)](https://pypi.org/project/coding-os/)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
 [![python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](./pyproject.toml)
 [![CI](https://github.com/kouroshez/coding-os/actions/workflows/ci.yml/badge.svg)](https://github.com/kouroshez/coding-os/actions/workflows/ci.yml)
@@ -81,6 +81,53 @@ Dynamic: license-file
 >
 > Website: <https://coding-os.dev> · Community: <https://community.coding-os.dev>
 
+<table>
+<tr>
+<td align="center" width="34%">
+<h3>💛 Sponsor</h3>
+<a href="https://github.com/sponsors/kouroshez"><b>GitHub Sponsors</b></a><br/>
+<a href="https://coding-os.dev/donate">One-off donation</a>
+<br/><sub>Keeps a single maintainer shipping</sub>
+</td>
+<td align="center" width="33%">
+<h3>💬 Community</h3>
+<a href="https://community.coding-os.dev"><b>Forum</b></a><br/>
+<a href="https://github.com/kouroshez/coding-os/discussions">Discussions</a>
+<br/><sub>Questions, setups, rough edges</sub>
+</td>
+<td align="center" width="33%">
+<h3>⭐ Star</h3>
+<a href="https://github.com/kouroshez/coding-os"><b>Follow the repo</b></a><br/>
+<a href="./CHANGELOG.md">Read the changelog</a>
+<br/><sub>The cheapest way to help</sub>
+</td>
+</tr>
+</table>
+
+**Free, and staying that way.** Apache-2.0, no paid tier, no telemetry, no
+gated features — the kernel you run is the whole thing. Sponsorship buys
+maintenance time, not access.
+
+### Right-sized by construction
+
+Loading a whole skill catalogue into every prompt is how agents run out of
+context before they run out of task. coding-os narrows it twice.
+
+**At `cos init`** — a project installs only the stacks it declares. A
+WordPress project gets the `wordpress` skill and never sees `go-patterns`,
+`rails` or `spring-boot`. Alongside them sit the stack-agnostic ones —
+`clean-code`, `testing-strategy`, `api-design`, `a11y`, `security-web` —
+which apply to any codebase.
+
+**On every turn** — what is on disk is not what is in context. A generated
+rules table maps file globs to skills, and the matching skill loads only
+when you are about to write a file it governs. Editing a React component
+loads `nextjs-react`; nothing else comes with it.
+
+What you pay per session is `AGENTS.md` plus the rules of the modules you
+enabled. Disable a module and its rules, tools and slash commands leave with
+it — see [Modular by design](#modular-by-design--take-only-what-you-need).
+
 ---
 
 ## Prerequisites
@@ -268,8 +315,9 @@ No Python edits required.
    (`cos_doc_search`) · task graph (`cos_task_*`) · knowledge graph
    (`cos_graph_*`).
 6. **Intent enforcement** — when the user uses exhaustive vocabulary
-   (FA + EN: همه / all / completely / until done), the Stop hook
-   refuses premature "done" until an evidence bundle is recorded.
+   ("all" / "every" / "completely" / "until done", matched in English
+   and one additional language), the Stop hook refuses premature "done"
+   until an evidence bundle is recorded.
 7. **Upgrade path** — `cos update` keeps every consumer project in
    sync with `coding-os` without touching user content.
 

{coding_os-0.3.4 → coding_os-0.3.6}/README.md

@@ -1,6 +1,6 @@
 # coding-os
 
-[![release](https://img.shields.io/github/v/release/kouroshez/coding-os?color=blue)](https://github.com/kouroshez/coding-os/releases)
+[![PyPI](https://img.shields.io/pypi/v/coding-os?color=blue&label=pypi)](https://pypi.org/project/coding-os/)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
 [![python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](./pyproject.toml)
 [![CI](https://github.com/kouroshez/coding-os/actions/workflows/ci.yml/badge.svg)](https://github.com/kouroshez/coding-os/actions/workflows/ci.yml)
@@ -15,6 +15,53 @@
 >
 > Website: <https://coding-os.dev> · Community: <https://community.coding-os.dev>
 
+<table>
+<tr>
+<td align="center" width="34%">
+<h3>💛 Sponsor</h3>
+<a href="https://github.com/sponsors/kouroshez"><b>GitHub Sponsors</b></a><br/>
+<a href="https://coding-os.dev/donate">One-off donation</a>
+<br/><sub>Keeps a single maintainer shipping</sub>
+</td>
+<td align="center" width="33%">
+<h3>💬 Community</h3>
+<a href="https://community.coding-os.dev"><b>Forum</b></a><br/>
+<a href="https://github.com/kouroshez/coding-os/discussions">Discussions</a>
+<br/><sub>Questions, setups, rough edges</sub>
+</td>
+<td align="center" width="33%">
+<h3>⭐ Star</h3>
+<a href="https://github.com/kouroshez/coding-os"><b>Follow the repo</b></a><br/>
+<a href="./CHANGELOG.md">Read the changelog</a>
+<br/><sub>The cheapest way to help</sub>
+</td>
+</tr>
+</table>
+
+**Free, and staying that way.** Apache-2.0, no paid tier, no telemetry, no
+gated features — the kernel you run is the whole thing. Sponsorship buys
+maintenance time, not access.
+
+### Right-sized by construction
+
+Loading a whole skill catalogue into every prompt is how agents run out of
+context before they run out of task. coding-os narrows it twice.
+
+**At `cos init`** — a project installs only the stacks it declares. A
+WordPress project gets the `wordpress` skill and never sees `go-patterns`,
+`rails` or `spring-boot`. Alongside them sit the stack-agnostic ones —
+`clean-code`, `testing-strategy`, `api-design`, `a11y`, `security-web` —
+which apply to any codebase.
+
+**On every turn** — what is on disk is not what is in context. A generated
+rules table maps file globs to skills, and the matching skill loads only
+when you are about to write a file it governs. Editing a React component
+loads `nextjs-react`; nothing else comes with it.
+
+What you pay per session is `AGENTS.md` plus the rules of the modules you
+enabled. Disable a module and its rules, tools and slash commands leave with
+it — see [Modular by design](#modular-by-design--take-only-what-you-need).
+
 ---
 
 ## Prerequisites
@@ -202,8 +249,9 @@ No Python edits required.
    (`cos_doc_search`) · task graph (`cos_task_*`) · knowledge graph
    (`cos_graph_*`).
 6. **Intent enforcement** — when the user uses exhaustive vocabulary
-   (FA + EN: همه / all / completely / until done), the Stop hook
-   refuses premature "done" until an evidence bundle is recorded.
+   ("all" / "every" / "completely" / "until done", matched in English
+   and one additional language), the Stop hook refuses premature "done"
+   until an evidence bundle is recorded.
 7. **Upgrade path** — `cos update` keeps every consumer project in
    sync with `coding-os` without touching user content.
 

{coding_os-0.3.4 → coding_os-0.3.6}/coding_os.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-os
-Version: 0.3.4
+Version: 0.3.6
 Summary: The cognitive operating system that gives AI agents memory, structure, and discipline
 Author-email: Kourosh Ebrahimzadeh <info@coding-os.dev>
 License-Expression: Apache-2.0
@@ -66,7 +66,7 @@ Dynamic: license-file
 
 # coding-os
 
-[![release](https://img.shields.io/github/v/release/kouroshez/coding-os?color=blue)](https://github.com/kouroshez/coding-os/releases)
+[![PyPI](https://img.shields.io/pypi/v/coding-os?color=blue&label=pypi)](https://pypi.org/project/coding-os/)
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
 [![python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](./pyproject.toml)
 [![CI](https://github.com/kouroshez/coding-os/actions/workflows/ci.yml/badge.svg)](https://github.com/kouroshez/coding-os/actions/workflows/ci.yml)
@@ -81,6 +81,53 @@ Dynamic: license-file
 >
 > Website: <https://coding-os.dev> · Community: <https://community.coding-os.dev>
 
+<table>
+<tr>
+<td align="center" width="34%">
+<h3>💛 Sponsor</h3>
+<a href="https://github.com/sponsors/kouroshez"><b>GitHub Sponsors</b></a><br/>
+<a href="https://coding-os.dev/donate">One-off donation</a>
+<br/><sub>Keeps a single maintainer shipping</sub>
+</td>
+<td align="center" width="33%">
+<h3>💬 Community</h3>
+<a href="https://community.coding-os.dev"><b>Forum</b></a><br/>
+<a href="https://github.com/kouroshez/coding-os/discussions">Discussions</a>
+<br/><sub>Questions, setups, rough edges</sub>
+</td>
+<td align="center" width="33%">
+<h3>⭐ Star</h3>
+<a href="https://github.com/kouroshez/coding-os"><b>Follow the repo</b></a><br/>
+<a href="./CHANGELOG.md">Read the changelog</a>
+<br/><sub>The cheapest way to help</sub>
+</td>
+</tr>
+</table>
+
+**Free, and staying that way.** Apache-2.0, no paid tier, no telemetry, no
+gated features — the kernel you run is the whole thing. Sponsorship buys
+maintenance time, not access.
+
+### Right-sized by construction
+
+Loading a whole skill catalogue into every prompt is how agents run out of
+context before they run out of task. coding-os narrows it twice.
+
+**At `cos init`** — a project installs only the stacks it declares. A
+WordPress project gets the `wordpress` skill and never sees `go-patterns`,
+`rails` or `spring-boot`. Alongside them sit the stack-agnostic ones —
+`clean-code`, `testing-strategy`, `api-design`, `a11y`, `security-web` —
+which apply to any codebase.
+
+**On every turn** — what is on disk is not what is in context. A generated
+rules table maps file globs to skills, and the matching skill loads only
+when you are about to write a file it governs. Editing a React component
+loads `nextjs-react`; nothing else comes with it.
+
+What you pay per session is `AGENTS.md` plus the rules of the modules you
+enabled. Disable a module and its rules, tools and slash commands leave with
+it — see [Modular by design](#modular-by-design--take-only-what-you-need).
+
 ---
 
 ## Prerequisites
@@ -268,8 +315,9 @@ No Python edits required.
    (`cos_doc_search`) · task graph (`cos_task_*`) · knowledge graph
    (`cos_graph_*`).
 6. **Intent enforcement** — when the user uses exhaustive vocabulary
-   (FA + EN: همه / all / completely / until done), the Stop hook
-   refuses premature "done" until an evidence bundle is recorded.
+   ("all" / "every" / "completely" / "until done", matched in English
+   and one additional language), the Stop hook refuses premature "done"
+   until an evidence bundle is recorded.
 7. **Upgrade path** — `cos update` keeps every consumer project in
    sync with `coding-os` without touching user content.
 

{coding_os-0.3.4 → coding_os-0.3.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "coding-os"
-version = "0.3.4"
+version = "0.3.6"
 description = "The cognitive operating system that gives AI agents memory, structure, and discipline"
 readme = "README.md"
 requires-python = ">=3.10"

{coding_os-0.3.4 → coding_os-0.3.6}/src/adapters/claude/README.md

@@ -3,4 +3,4 @@
 - **Install:** `bash src/adapters/claude/install.sh` (or `make sync`).
 - **Manifest:** [adapter.yaml](adapter.yaml) — hook capabilities, MCP launch metadata, optional `presence` block for Hub board pills.
 - **Agent SDK:** [sdk_dispatcher.py](sdk_dispatcher.py) and other adapter-local scripts. Per **P8** in repo `AGENTS.md`, do not import adapter SDK code from `src/core/**`.
-- **Architecture checklist:** Anthropic Certified Architect foundations guide (repo copy under `docs/code-os-core-docs/instructor_Claude+Certified+Architect+–+Foundations+Certification+Exam+Guide.md`) — hooks / MCP / session topics map to this adapter + `src/core/hooks/`; see [docs/engineering/adapter-parity.md](../../docs/engineering/adapter-parity.md).
+- **Architecture checklist:** [docs/engineering/adapter-parity.md](../../docs/engineering/adapter-parity.md) — how hook, MCP and session capabilities map onto this adapter and `src/core/hooks/`.

{coding_os-0.3.4 → coding_os-0.3.6}/src/adapters/claude/adapter.yaml

@@ -65,6 +65,9 @@ hooks_dir: ".claude/hooks"
 rules_dir: ".claude/rules"
 skills_dir: ".claude/skills"
 commands_dir: ".claude/commands"
+# Claude Code reads CLAUDE.md, not AGENTS.md — scaffolding links it at the
+# AGENTS.md SSOT instead of copying, so the two can never fork.
+entrypoint_file: "CLAUDE.md"
 sourced_hooks: [cos-env.sh]
 supports_rules: true
 supports_settings_json: true

{coding_os-0.3.4 → coding_os-0.3.6}/src/adapters/codex/adapter.yaml

@@ -26,6 +26,9 @@ hooks_dir: ".codex/hooks"
 rules_dir: ".codex/rules"
 skills_dir: ".codex/skills"
 commands_dir: ".codex/commands"
+# Codex reads AGENTS.md at the project root natively, so it needs no linked
+# entrypoint of its own.
+entrypoint_file: null
 sourced_hooks: [cos-env.sh]
 supports_rules: true
 supports_settings_json: true

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/_data_types.py

@@ -217,6 +217,10 @@ class AdapterProfile:
     # src/cli/board_commands.py::_detect_agent_runtime so the CLI can attribute
     # task transitions without hardcoded adapter-name literals (rule #11).
     runtime_env_markers: tuple[str, ...] = ()
+    # Project-root filename this runtime reads as its instruction entrypoint
+    # (Claude: CLAUDE.md). Scaffolding links it at AGENTS.md, eject removes it;
+    # None means the runtime reads AGENTS.md directly, like Codex.
+    entrypoint_file: str | None = None
 
 
 @dataclass(frozen=True)

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/_init_helpers.py

@@ -483,6 +483,26 @@ def ensure_agents_md(project: Path, world: AggregatedWorld) -> bool:
     return True
 
 
+def ensure_entrypoint_symlink(project: Path, entrypoint_file: str | None) -> bool:
+    """Link an adapter's root entrypoint filename at AGENTS.md. Idempotent.
+
+    Returns True if the symlink was just created. A relative link — never a
+    copy — so the instruction SSOT cannot fork. An adapter that declares no
+    entrypoint gets nothing, and an existing file or symlink of that name is
+    left alone, which is what lets `init`, `add-adapter`, and `update` all
+    call this without clobbering a user's own file.
+    """
+    if not entrypoint_file:
+        return False
+    link = project / entrypoint_file
+    if link.exists() or link.is_symlink():
+        return False
+    if not (project / "AGENTS.md").exists():
+        return False
+    link.symlink_to("AGENTS.md")
+    return True
+
+
 def materialize_makefile_targets(project: Path, state: Path, world: AggregatedWorld) -> bool:
     """Render stack-contributed make targets into a generated include and wire
     it into the project Makefile.

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/adapter_registry.py

@@ -156,6 +156,19 @@ def _load_one(manifest_path: Path) -> AdapterProfile:
             paths.append(McpLaunchConfigPath(scope=scope, path=path_val))
         mcp_launch = McpLaunchSpec(loader=loader, config_paths=tuple(paths))
 
+    # A community adapter must not be able to link outside the project root, so
+    # the entrypoint is restricted to a bare filename before it ever reaches a
+    # symlink call. Spec: docs/playbooks/adapter-authoring.md § The root entrypoint.
+    entrypoint_file = data.get("entrypoint_file") or None
+    if entrypoint_file is not None and (
+        not isinstance(entrypoint_file, str)
+        or Path(entrypoint_file).name != entrypoint_file
+        or entrypoint_file in (".", "..")
+    ):
+        raise AdapterManifestError(
+            f"{manifest_path}: 'entrypoint_file' must be a bare filename, got {entrypoint_file!r}"
+        )
+
     runtime_env_markers_raw = data.get("runtime_env_markers") or []
     if not isinstance(runtime_env_markers_raw, list) or not all(
         isinstance(v, str) and v for v in runtime_env_markers_raw
@@ -181,6 +194,7 @@ def _load_one(manifest_path: Path) -> AdapterProfile:
         mcp_helper=mcp_helper,
         mcp_launch=mcp_launch,
         runtime_env_markers=tuple(runtime_env_markers_raw),
+        entrypoint_file=entrypoint_file,
     )
 
 

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/add_stack.py

@@ -1,6 +1,6 @@
 """`cos add-stack <id>` — add a stack module to an already-initialized project.
 
-Design (see plan §۲.۳):
+Design (see plan §2.3):
 
 1. Load the project config. Check the project has been initialized.
 2. If the stack is already installed → idempotent skip with INFO.

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/aggregator.py

@@ -3,7 +3,7 @@
 No IO. No filesystem access. Deterministic output for a given input.
 Fully testable as a plain function.
 
-Merge rules (§۲ of the plan):
+Merge rules (§2 of the plan):
     1. substitutions       shallow merge, later wins, conflict warned
     2. verify_rows         concat + dedupe by (glob, suites)
     3. routing_entries     concat + dedupe by string, order preserved

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/main.py

@@ -38,6 +38,7 @@ from cli._resources import (
 from cli._init_helpers import (
     InitError,
     ensure_agents_md,
+    ensure_entrypoint_symlink,
     ensure_gitignore,
     install_consumer_git_hooks,
     materialize_ci_workflow,
@@ -2335,6 +2336,14 @@ def _run_scaffold_phase(
     if ensure_agents_md(project, world):
         click.echo("  Generated AGENTS.md")
 
+    # 10b. Link each agent's own root entrypoint (Claude reads CLAUDE.md, not
+    # AGENTS.md) at that one SSOT. Filename comes from the adapter's own yaml,
+    # never a literal here (Rule 11).
+    for agent in agents:
+        entrypoint = _get_adapter_registry()[agent].entrypoint_file
+        if ensure_entrypoint_symlink(project, entrypoint):
+            click.echo(f"  Linked {entrypoint} → AGENTS.md")
+
     # 11. Initial RAG indexing of the scaffolded docs so `cos_doc_search`
     # returns hits from the very first session. Without this, the
     # consumer's document_chunks table is empty until the user runs
@@ -2523,6 +2532,10 @@ def add_adapter(agent: str, project_dir: str) -> None:
     if ensure_agents_md(project, world):
         click.echo("  Generated AGENTS.md")
 
+    entrypoint = _get_adapter_registry()[agent].entrypoint_file
+    if ensure_entrypoint_symlink(project, entrypoint):
+        click.echo(f"  Linked {entrypoint} → AGENTS.md")
+
 
 @cli.command("codex-mcp-install")
 @click.option(
@@ -2719,12 +2732,18 @@ def eject(project_dir: str, yes: bool) -> None:
         for p in (Path(root) / n for root, _d, fs in os.walk(project) for n in fs)
         if p.is_symlink() and _is_coding_os_symlink(p)
     ]
-    # CLAUDE.md is the generated symlink to AGENTS.md (points at a sibling, so
-    # the meta-repo filter above misses it) — treat any symlinked one as ours.
-    claude_md = project / "CLAUDE.md"
+    # An adapter's root entrypoint is a generated symlink to AGENTS.md; it
+    # points at a sibling, so the meta-repo filter above misses it. Only a
+    # still-symlinked one is ours — a user who replaced it with a real file
+    # keeps that file. Filenames come from adapter.yaml, never a literal here.
     generated_entrypoints = [config, project / "AGENTS.md"]
-    if claude_md.is_symlink():
-        generated_entrypoints.append(claude_md)
+    generated_entrypoints += [
+        link
+        for name in sorted(
+            {p.entrypoint_file for p in _get_adapter_registry().values() if p.entrypoint_file}
+        )
+        if (link := project / name).is_symlink()
+    ]
 
     present = [f for f in generated_entrypoints if f.exists() or f.is_symlink()]
     if not coding_os_links and not state_dir.exists() and not present:

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/renderer.py

@@ -250,7 +250,7 @@ _CI_LANGUAGE_SETUP: dict[str, tuple[str, ...]] = {
     "typescript": (
         "uses: actions/setup-node@v4",
         "with:",
-        '  node-version: "20"',
+        '  node-version: "22"',
     ),
     "go": (
         "uses: actions/setup-go@v5",
@@ -420,14 +420,14 @@ CMD ["python", "-m", "app.main"]
 """,
     "typescript": """\
 # syntax=docker/dockerfile:1
-FROM node:20-slim AS build
+FROM node:22-slim AS build
 WORKDIR /app
 COPY package*.json ./
 RUN npm ci
 COPY . .
 RUN npm run build --if-present
 
-FROM node:20-slim AS runtime
+FROM node:22-slim AS runtime
 WORKDIR /app
 ENV NODE_ENV=production
 COPY --from=build /app ./

{coding_os-0.3.4 → coding_os-0.3.6}/src/cli/update.py

@@ -30,6 +30,7 @@ logger = logging.getLogger(__name__)
 
 from cli._init_helpers import (
     ensure_agents_md,
+    ensure_entrypoint_symlink,
     materialize_ci_workflow,
     materialize_dockerfiles,
     materialize_makefile_targets,
@@ -554,6 +555,19 @@ def update(
                         click.echo("  Refreshed backend Dockerfile(s)")
                         overall_changes = True
 
+            # Backfill each agent's root entrypoint symlink — projects
+            # scaffolded before adapter.yaml declared one never got it. Runs
+            # after the AGENTS.md gap-fill above, which it links at.
+            adapter_profiles = load_adapter_registry(
+                ADAPTERS_DIR, overlay_dirs=overlay_adapter_dirs()
+            )
+            for agent in agents:
+                profile = adapter_profiles.get(agent)
+                entrypoint = profile.entrypoint_file if profile else None
+                if ensure_entrypoint_symlink(project, entrypoint):
+                    click.echo(f"  Linked {entrypoint} → AGENTS.md")
+                    overall_changes = True
+
         # Symlinks still dangling AFTER re-link point at a source the current
         # registry no longer ships (or a meta-repo path that no longer exists)
         # — a re-install can never heal them, so prune (same contract as

{coding_os-0.3.4 → coding_os-0.3.6}/src/core/graph_os/tools/graph.py

@@ -5102,9 +5102,8 @@ def cos_graph_doctor(
             #     `[text](path)` syntax including trailing backtick)
             #   - contains newline / control char (raw prose fragment)
             # NOTE: a plain space is NOT malformed — legitimate doc files
-            # have spaces in their names (e.g. Roy Fielding's REST
-            # dissertation). Flagging space caused a delete↔reindex churn
-            # of 475 real nodes (R4 follow-up false-positive).
+            # have spaces in their names. Flagging space caused a
+            # delete↔reindex churn of 475 real nodes.
             def _is_malformed(p: str) -> bool:
                 return (
                     ("../" in p)