uncoded 1.1.0__tar.gz → 2.0.0__tar.gz

uncoded-1.1.0/AGENTS.md → uncoded-2.0.0/.agents/skills/uncoded-code-navigation/SKILL.md

@@ -1,79 +1,16 @@
-# uncoded
+---
+name: uncoded-code-navigation
+description: Use before searching, reading, or editing Python source in a codebase indexed by uncoded — locating a symbol, reading a definition, or checking references before a refactor, rename, or delete.
+---
 
-## Problem
+# Code Navigation
 
-AI coding agents navigate codebases poorly. They grep for guessed keywords,
-skim the first few lines of files, and fill gaps from pretraining rather than
-reading the actual code. System prompts encourage this with "make reasonable
-assumptions." The result is plausible-looking output built on a hallucinated
-understanding of code that's sitting right there, unread.
-
-## Approach
-
-A static, pre-computed index gives agents a top-down view of a codebase.
-The agent loads the index at the start of a task, sees the full vocabulary
-of the code, and navigates deterministically to what it needs — no guessing,
-no grep.
-
-Index artefacts — generated from the configured roots:
-
-1. **Namespace map** (`.uncoded/namespace.yaml`) — a hierarchical YAML file
-   listing all symbols: directories, files, classes (with attributes
-   and methods), and functions. Covers both source and tests. Loaded into
-   context before any task begins. Gives the agent a world view.
-
-2. **Stub files** (`.uncoded/stubs/`) — one `.pyi` per source file, with
-   imports, full signatures (parameter names, types, return types),
-   module constants, and class attributes.
-
-3. **Doc map** (`.uncoded/docs.yaml`) — a heading outline of every Markdown
-   file in configured `doc-roots`. Each file nests its ATX headings as keys.
-   Agents load this to orient to the documentation, then navigate to a
-   heading with `Read` or `grep`. Generated only when `doc-roots` is set.
-   Outline only — no `uncoded body`, `uncoded refs`, or stubs for Markdown.
-
-Alongside the index, uncoded ships `uncoded body` to read symbol bodies and
-`uncoded refs` to find all references. See "How to read and edit code in
-this codebase" below for the dispatch rule.
-
-## Commands
-
-This project uses [uv](https://docs.astral.sh/uv/). Run `uncoded` commands
-via `uvx` so they run the published package without needing to install it;
-run project tooling (`pytest`, `pre-commit`) via `uv run`.
-
-```sh
-# Generate (or update) the namespace map, stub files, docs.yaml,
-# and instruction-file sections
-uvx uncoded sync
-
-# Verify the index without writing; exits non-zero if any file would change
-uvx uncoded check
-
-# Print the source body of a named symbol to stdout
-uvx uncoded body <name_path> --in <relative_path>
-
-# Find references to a symbol
-uvx uncoded refs <name_path> --in <relative_path>
-
-# Run tests (branch coverage enforced; see [tool.coverage.report]
-# in pyproject.toml)
-uv run pytest
-
-# Run a subset of tests without the coverage gate
-uv run pytest tests/test_stubs.py --no-cov
-```
-
-<!-- uncoded:start -->
-## How to read and edit code in this codebase
-
-This repo uses [uncoded](https://github.com/alimanfoo/uncoded) to maintain
-a symbol index over its source code, with two associated tools:
+This codebase uses [uncoded](https://github.com/alimanfoo/uncoded) to maintain
+a symbol index over its source code, with two associated CLI tools:
 `uncoded body` for reading a symbol's body and `uncoded refs` for finding
 references.
-The point of this scaffolding is one rule.
 
-### The dispatch rule
+## The dispatch rule
 
 **If your search term is the name of a Python symbol — a class, function,
 method, attribute, or module-level constant — use the index. If it's a
@@ -81,17 +18,17 @@ pattern, regex, or free-text phrase, use grep.**
 
 This applies to every tool call where you are trying to find code, not
 just the first one in the session. The pretrained reflex for "find X" is
-grep, and that reflex is wrong here. `grep -rn 'def resolve_body'` to read a
-function's body is the rule firing — that is `uncoded body`. `grep -rn
-'function_name'` to check whether something has callers before a refactor is
-the rule firing — that is `uncoded refs`. `grep` then `Edit` to delete
-dead code is the rule firing — that is `uncoded refs` to confirm dead,
+grep, and that reflex is wrong here. `grep -rn 'def parse_config'` to read a
+function's body applies the rule — that is `uncoded body`. `grep -rn
+'validate_input'` to check whether something has callers before a refactor is
+another case — that is `uncoded refs`. `grep` then `Edit` to delete
+dead code fits the same pattern — that is `uncoded refs` to confirm dead,
 then `Edit`. The grep version of any of these is noisier and less reliable:
 grep matches comments, strings, and unrelated attributes; grep misses
 re-exports (so caller and delete checks come back incomplete); grep forces
 offset arithmetic to slice a body. The indexed tools don't.
 
-### How to execute the rule
+## How to execute the rule
 
 The index has two parts (a namespace map and per-file stubs) and three
 steps (orient, understand, act).
@@ -154,7 +91,7 @@ With the map and stub loaded, you have the exact `relative_path` and
 - **Safely delete.** `uvx uncoded refs <name_path> --in <relative_path>` must
   return empty; then `Edit` to remove.
 
-### Where Read, Edit, and grep are still the right tools
+## Where Read, Edit, and grep are still the right tools
 
 The rule is about source navigation by symbol name. Outside that, Read,
 Edit, and grep stay correct:
@@ -170,11 +107,3 @@ Edit, and grep stay correct:
 
 The dispatch rule turns on the search term: a symbol name → the index; a
 regex or free-text phrase → grep.
-<!-- uncoded:end -->
-<!-- uncoded:docs:start -->
-## How to read documentation in this codebase
-
-`.uncoded/docs.yaml` is an orientation outline: it lists every Markdown file
-and its heading hierarchy. Headings are literal text — use `Read` or `grep`
-to navigate to a section.
-<!-- uncoded:docs:end -->

{uncoded-1.1.0/.agents/skills/coherence-review → uncoded-2.0.0/.agents/skills/uncoded-coherence-review}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: coherence-review
-description: "Perform a coherence review of a Python codebase: a diagnostic sweep for semantic drift, naming inconsistency, promissory mismatch, and structural incoherence. Produces a Markdown report of findings with verbatim evidence and confidence levels, for human investigation. Assumes uncoded is installed (.uncoded/namespace.yaml and .uncoded/stubs/ present)."
+name: uncoded-coherence-review
+description: 'Perform a coherence review of a Python codebase: a diagnostic sweep for semantic drift, naming inconsistency, promissory mismatch, and structural incoherence. Produces a Markdown report of findings with verbatim evidence and confidence levels, for human investigation. Assumes uncoded is installed (.uncoded/namespace.yaml and .uncoded/stubs/ present).'
 ---
 
 # Coherence Review

uncoded-2.0.0/.agents/skills/uncoded-doc-navigation/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: uncoded-doc-navigation
+description: Use before searching or reading a codebase's Markdown documentation indexed by uncoded — locating which file and section cover a topic, or orienting to what documentation exists.
+---
+
+# Documentation Navigation
+
+This codebase uses [uncoded](https://github.com/alimanfoo/uncoded) to maintain
+a documentation index.
+
+**Step 1 — Orient. Read the docs map first.** Before answering the
+user, before any other tool call:
+
+```text
+Read .uncoded/docs.yaml
+```
+
+`.uncoded/docs.yaml` is an orientation outline: it lists every Markdown file
+and its heading hierarchy. Read it in full, now.
+
+**Step 2 — Navigate.** Headings in the map are literal text. Use `Read` or
+`grep` to navigate to a specific section identified in the map.

uncoded-2.0.0/.claude/skills/uncoded-code-navigation/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: uncoded-code-navigation
+description: Use before searching, reading, or editing Python source in a codebase indexed by uncoded — locating a symbol, reading a definition, or checking references before a refactor, rename, or delete.
+---
+
+# Code Navigation
+
+This codebase uses [uncoded](https://github.com/alimanfoo/uncoded) to maintain
+a symbol index over its source code, with two associated CLI tools:
+`uncoded body` for reading a symbol's body and `uncoded refs` for finding
+references.
+
+## The dispatch rule
+
+**If your search term is the name of a Python symbol — a class, function,
+method, attribute, or module-level constant — use the index. If it's a
+pattern, regex, or free-text phrase, use grep.**
+
+This applies to every tool call where you are trying to find code, not
+just the first one in the session. The pretrained reflex for "find X" is
+grep, and that reflex is wrong here. `grep -rn 'def parse_config'` to read a
+function's body applies the rule — that is `uncoded body`. `grep -rn
+'validate_input'` to check whether something has callers before a refactor is
+another case — that is `uncoded refs`. `grep` then `Edit` to delete
+dead code fits the same pattern — that is `uncoded refs` to confirm dead,
+then `Edit`. The grep version of any of these is noisier and less reliable:
+grep matches comments, strings, and unrelated attributes; grep misses
+re-exports (so caller and delete checks come back incomplete); grep forces
+offset arithmetic to slice a body. The indexed tools don't.
+
+## How to execute the rule
+
+The index has two parts (a namespace map and per-file stubs) and three
+steps (orient, understand, act).
+
+**Step 1 — Orient. Read the namespace map first.** Before answering the
+user, before any other tool call:
+
+```text
+Read .uncoded/namespace.yaml
+```
+
+This lists every symbol in the codebase — directories, files, classes,
+methods, functions. Without it loaded, "find X" answers come from
+pretrained guesses about what a project like this *probably* contains,
+rather than what is actually here. Read it once, in full, at session
+start.
+
+**Step 2 — Understand. Read the `.pyi` stub before any `.py` source.**
+Stub paths mirror source paths under `.uncoded/stubs/`:
+
+```text
+src/foo/bar.py      →  .uncoded/stubs/src/foo/bar.pyi
+tests/test_foo.py   →  .uncoded/stubs/tests/test_foo.pyi
+```
+
+Every file you intend to touch or reference, including tests. The stub
+contains imports, every signature with types, module-level assignments,
+and class attributes — enough for most navigation. Skipping straight to
+source means reading many lines to learn what the stub would have told
+you in one. If no stub exists at the expected path, the file has no
+symbols indexed; in that narrow case, read source directly.
+
+**Step 3 — Act. Use `uncoded body` to read a symbol's body;
+use `uncoded refs` to find every reference to a symbol; use `Edit` (with
+`uncoded body`'s output as `old_string`) to change a symbol.**
+With the map and stub loaded, you have the exact `relative_path` and
+`name_path` each tool needs (`ClassName/method` for a method,
+`function_name` for a top-level function). Per task:
+
+- **Read a symbol's body.** `uvx uncoded body <name_path> --in <relative_path>` —
+  prints the symbol's source text to stdout, byte-identical to disk.
+  Returns exactly the symbol; no offset arithmetic, no risk of reading
+  too much. Its output has every byte `Edit` needs as `old_string` — no
+  extra `Read` required for partial edits. Stay on stubs for a
+  wider sweep.
+
+- **Find every reference to a symbol.**
+  `uvx uncoded refs <name_path> --in <relative_path>`. Prints one reference
+  per line as `file:line:col`, sorted. Grep on the name misses re-exports
+  and adds false positives from comments, strings, and attribute lookups
+  on other types. If the next move depends on the answer being complete,
+  grep cannot give you that.
+
+- **Edit a symbol.** `uvx uncoded body <name_path> --in <relative_path>` gives
+  the exact `old_string`; then `Edit` to apply the change.
+
+- **Rename.** `uvx uncoded refs <name_path> --in <relative_path>` enumerates
+  every site; then `Edit` at each.
+
+- **Safely delete.** `uvx uncoded refs <name_path> --in <relative_path>` must
+  return empty; then `Edit` to remove.
+
+## Where Read, Edit, and grep are still the right tools
+
+The rule is about source navigation by symbol name. Outside that, Read,
+Edit, and grep stay correct:
+
+- Free-text or pattern search outside source: Markdown, YAML, TOML,
+  configs, commit messages, notebook JSON, fixture data.
+- Pattern search across signatures (regex over type annotations,
+  decorator usage, alias declarations) — these are not symbol-name
+  lookups even though they sit inside source.
+- Partial-line edits inside a symbol body, once you have retrieved it
+  via `uncoded body`.
+- The rare stub-less Python file that needs exploratory reading.
+
+The dispatch rule turns on the search term: a symbol name → the index; a
+regex or free-text phrase → grep.

{uncoded-1.1.0/.claude/skills/coherence-review → uncoded-2.0.0/.claude/skills/uncoded-coherence-review}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: coherence-review
-description: "Perform a coherence review of a Python codebase: a diagnostic sweep for semantic drift, naming inconsistency, promissory mismatch, and structural incoherence. Produces a Markdown report of findings with verbatim evidence and confidence levels, for human investigation. Assumes uncoded is installed (.uncoded/namespace.yaml and .uncoded/stubs/ present)."
+name: uncoded-coherence-review
+description: 'Perform a coherence review of a Python codebase: a diagnostic sweep for semantic drift, naming inconsistency, promissory mismatch, and structural incoherence. Produces a Markdown report of findings with verbatim evidence and confidence levels, for human investigation. Assumes uncoded is installed (.uncoded/namespace.yaml and .uncoded/stubs/ present).'
 ---
 
 # Coherence Review

uncoded-2.0.0/.claude/skills/uncoded-doc-navigation/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: uncoded-doc-navigation
+description: Use before searching or reading a codebase's Markdown documentation indexed by uncoded — locating which file and section cover a topic, or orienting to what documentation exists.
+---
+
+# Documentation Navigation
+
+This codebase uses [uncoded](https://github.com/alimanfoo/uncoded) to maintain
+a documentation index.
+
+**Step 1 — Orient. Read the docs map first.** Before answering the
+user, before any other tool call:
+
+```text
+Read .uncoded/docs.yaml
+```
+
+`.uncoded/docs.yaml` is an orientation outline: it lists every Markdown file
+and its heading hierarchy. Read it in full, now.
+
+**Step 2 — Navigate.** Headings in the map are literal text. Use `Read` or
+`grep` to navigate to a specific section identified in the map.

{uncoded-1.1.0 → uncoded-2.0.0}/.uncoded/docs.yaml

@@ -21,14 +21,11 @@ README.md:
     Coherence review:
     Dev setup:
       Note for Windows contributors:
+    Upgrading from v1:
     Releasing:
 AGENTS.md:
   uncoded:
     Problem:
     Approach:
     Commands:
-    How to read and edit code in this codebase:
-      The dispatch rule:
-      How to execute the rule:
-      Where Read, Edit, and grep are still the right tools:
-    How to read documentation in this codebase:
+    Skills:

{uncoded-1.1.0 → uncoded-2.0.0}/.uncoded/namespace.yaml

@@ -18,6 +18,7 @@ src/:
       resolve_body:
       _extract_body:
     cli.py:
+      _sync_code_artefacts:
       _sync:
       _body:
       _refs:
@@ -28,7 +29,6 @@ src/:
         project_root:
         source_roots:
         doc_roots:
-        instruction_files:
       find_pyproject_toml:
       _has_uncoded_section:
       _find_config_file:
@@ -54,22 +54,12 @@ src/:
       extract_module:
       iter_source_files:
       extract_modules:
-    instruction_files.py:
-      MARKER_START:
-      MARKER_END:
-      MARKER_DOCS_START:
-      MARKER_DOCS_END:
-      DEFAULT_INSTRUCTION_FILES:
-      _CODE_SECTION_BODY:
-      SECTION_CODE:
-      _DOCS_SECTION_BODY:
-      SECTION_DOCS:
-      _apply_section:
-      sync_instruction_file:
     namespace_map.py:
       HEADER:
       build_map:
       render_map:
+    read_helpers.py:
+      _read_file_text_as_utf8:
     refs.py:
       TY_VERSION:
       Reference:
@@ -103,10 +93,18 @@ src/:
       resolve_ast_node_from_source:
       _resolve_class_member:
     skill.py:
-      SKILL_OUTPUTS:
-      LEGACY_SKILL_OUTPUTS:
-      _SKILL_CONTENT:
-      sync_skill:
+      SKILL_ROOTS:
+      SKILLS:
+      Skill:
+        name:
+        description:
+        body_file:
+        gate:
+        legacy_names:
+      _skill_path:
+      _render_content:
+      _remove_skill_file:
+      sync_skills:
     stubs.py:
       VALUE_WIDTH_CAP:
       StubParam:
@@ -209,11 +207,12 @@ tests/:
     TestResolveBodyByteIdentical:
       test_exact_source_returned:
   test_cli.py:
+    _CODE_SKILL_PATHS:
+    _DOC_SKILL_PATHS:
+    _SKILL_PATHS:
     TestSyncApplyMode:
-      test_writes_namespace_map_stubs_and_instruction_file:
+      test_writes_namespace_map_stubs_and_skills:
       test_idempotent_second_run:
-      test_dedupes_when_claude_md_is_symlink_to_agents_md:
-      test_error_when_instruction_file_outside_project_root:
       test_error_when_no_config_file:
       test_error_when_source_root_outside_project_root:
       test_error_when_source_root_missing:
@@ -227,8 +226,6 @@ tests/:
       test_returns_zero_when_index_is_up_to_date:
       test_returns_one_when_source_changes_after_sync:
       test_returns_one_when_source_file_deleted:
-      test_returns_one_when_instruction_file_drifts:
-      test_dedupes_when_claude_md_is_symlink_to_agents_md:
       test_error_still_returns_one:
     TestMainDispatch:
       test_sync_subcommand_runs_in_apply_mode:
@@ -264,18 +261,19 @@ tests/:
       test_doc_only_writes_docs_yaml:
       test_doc_only_does_not_write_namespace_yaml:
       test_doc_only_does_not_write_stubs:
-      test_doc_only_instruction_file_has_docs_section_only:
       test_doc_root_single_md_file:
       test_error_when_doc_root_missing:
       test_error_when_doc_root_is_non_md_file:
       test_error_when_doc_root_outside_project_root:
       test_both_roots_writes_both_artefacts:
-      test_both_roots_instruction_file_has_both_sections:
       test_source_root_removal_cleans_code_artefacts:
       test_doc_root_removal_cleans_docs_yaml:
       test_check_returns_one_when_docs_yaml_stale:
       test_check_returns_one_when_stubs_should_be_removed:
       test_check_returns_one_when_docs_yaml_should_be_removed:
+      test_doc_only_does_not_write_skill:
+      test_doc_only_removes_preexisting_skill:
+      test_check_returns_one_when_skill_should_be_removed:
       test_idempotent_doc_only:
     _init_repo:
     _init_doc_repo:
@@ -291,9 +289,6 @@ tests/:
       test_both_roots_empty_when_section_absent:
       test_project_root_is_config_file_parent:
       test_finds_pyproject_in_parent_directory:
-      test_instruction_files_default_when_key_absent:
-      test_instruction_files_configured:
-      test_instruction_files_empty_list_respected:
       test_returns_frozen_dataclass:
       test_finds_uncoded_toml_when_no_pyproject:
       test_uncoded_toml_top_level_keys:
@@ -336,6 +331,8 @@ tests/:
       test_directory_nested_subdir:
       test_empty_directory_yields_nothing:
       test_rel_path_is_relative_to_project_root:
+      test_skips_non_utf8_file_with_warning:
+      test_single_file_root_unreadable_yields_nothing:
     TestBuildDocsMap:
       test_empty_files:
       test_headingless_file_maps_to_null:
@@ -376,45 +373,12 @@ tests/:
       test_includes_init_with_symbols:
       test_skips_empty_init:
       test_skips_syntax_errors:
+      test_skips_non_utf8_file_with_warning:
     TestExtractModulesFromFiles:
       test_returns_module_info_per_parseable_file:
       test_preserves_source_order:
       test_module_with_only_constants_is_kept:
       test_skips_files_with_no_symbols:
-  test_instruction_files.py:
-    TestCodeSection:
-      test_contains_markers:
-      test_markers_in_order:
-      test_ends_with_newline:
-    TestDocsSection:
-      test_contains_markers:
-      test_markers_in_order:
-      test_ends_with_newline:
-      test_mentions_docs_yaml:
-    TestSyncInstructionFile:
-      test_creates_file_with_code_section:
-      test_appends_code_section_to_existing_file:
-      test_replaces_existing_code_section:
-      test_preserves_content_after_code_section:
-      test_removes_code_section_on_none:
-      test_appends_docs_section:
-      test_removes_docs_section_on_none:
-      test_both_sections_appended_in_order:
-      test_both_sections_replaced_independently:
-      test_code_only_does_not_write_docs_markers:
-      test_docs_only_does_not_write_code_markers:
-      test_idempotent:
-      test_returns_true_on_first_write:
-      test_returns_false_when_clean:
-      test_returns_false_when_both_none_and_file_absent:
-      test_remove_section_absent_is_noop:
-    TestSyncInstructionFileCheckMode:
-      test_does_not_create_file:
-      test_does_not_update_existing_file:
-      test_reports_no_change_when_clean:
-    TestSyncInstructionFileProjectRootAnchor:
-      test_project_root_anchors_create_independent_of_cwd:
-      test_project_root_anchors_update_of_existing_file:
   test_namespace_map.py:
     TestBuildMap:
       test_single_file:
@@ -464,19 +428,35 @@ tests/:
     _init_response:
     _shutdown_response:
   test_skill.py:
-    TestSyncSkill:
-      test_skill_name_and_output_paths:
+    TestSyncSkills:
+      test_skill_registry:
       test_writes_skill_files:
       test_creates_parent_directories:
-      test_returns_true_on_first_write:
-      test_returns_false_when_already_in_sync:
+      test_content_has_frontmatter_and_body:
+      test_renderer_supplies_separator_for_body_without_leading_newline:
+      test_returns_change_count_on_first_write:
+      test_returns_zero_when_already_in_sync:
       test_idempotent:
       test_check_mode_does_not_write:
       test_check_mode_reports_change_when_missing:
       test_check_mode_reports_no_change_when_in_sync:
       test_removes_legacy_skill_files:
-      test_check_mode_reports_legacy_skill_files_without_removing:
-    TestSyncSkillProjectRootAnchor:
+      test_check_mode_reports_legacy_files_without_removing:
+      test_source_false_removes_existing_skill_files:
+      test_source_false_returns_zero_when_already_absent:
+      test_source_false_check_mode_reports_without_removing:
+      test_gate_unmet_removal_prunes_empty_directory:
+      test_legacy_removal_prunes_empty_directory:
+      test_pruning_skipped_when_directory_has_other_files:
+      test_docs_gate_builds_when_docs_true:
+      test_docs_gate_skips_when_docs_false:
+      test_no_legacy_names_skips_legacy_removal:
+      test_code_navigation_written_when_source_set:
+      test_code_navigation_not_written_when_source_absent:
+      test_doc_navigation_written_when_docs_set:
+      test_doc_navigation_not_written_when_docs_absent:
+      test_doc_navigation_content_includes_orient_step:
+    TestSyncSkillsProjectRootAnchor:
       test_project_root_anchors_writes_independent_of_cwd:
       test_project_root_anchors_legacy_removal_independent_of_cwd:
   test_stubs.py:

{uncoded-1.1.0 → uncoded-2.0.0}/.uncoded/stubs/src/uncoded/cli.pyi

@@ -7,14 +7,16 @@ from uncoded.body import resolve_body
 from uncoded.config import ConfigError, read_config
 from uncoded.docs_map import build_docs_map, iter_doc_files, render_docs_map
 from uncoded.extract import extract_modules, iter_source_files
-from uncoded.instruction_files import SECTION_CODE, SECTION_DOCS, sync_instruction_file
 from uncoded.namespace_map import build_map, render_map
 from uncoded.refs import find_refs
 from uncoded.resolver import NamePath, SymbolNotFound, UnsupportedNamePath
-from uncoded.skill import sync_skill
+from uncoded.skill import sync_skills
 from uncoded.stubs import build_stubs, remove_all_stubs
 from uncoded.sync import remove_file, sync_file
 
+def _sync_code_artefacts(*, build: bool, configured_source_roots: list[Path], project_root: Path, resolved_project_root: Path, check: bool) -> int | None:
+    ...
+
 def _sync(*, start: Path | None, check: bool) -> int:
     ...
 

{uncoded-1.1.0 → uncoded-2.0.0}/.uncoded/stubs/src/uncoded/config.pyi

@@ -3,7 +3,6 @@
 import tomllib
 from dataclasses import dataclass
 from pathlib import Path
-from uncoded.instruction_files import DEFAULT_INSTRUCTION_FILES
 
 def find_pyproject_toml(start: Path) -> Path | None:
     ...
@@ -24,4 +23,3 @@ class Config:
     project_root: Path
     source_roots: list[Path]
     doc_roots: list[Path]
-    instruction_files: list[Path]

{uncoded-1.1.0 → uncoded-2.0.0}/.uncoded/stubs/src/uncoded/docs_map.pyi

@@ -2,6 +2,7 @@
 
 from collections.abc import Iterable, Iterator
 from pathlib import Path
+from uncoded.read_helpers import _read_file_text_as_utf8
 from uncoded.yaml_tree import render_yaml_tree
 
 DOCS_HEADER = ...

{uncoded-1.1.0 → uncoded-2.0.0}/.uncoded/stubs/src/uncoded/extract.pyi

@@ -6,6 +6,7 @@ from collections.abc import Iterable, Iterator
 from dataclasses import dataclass, field
 from pathlib import Path
 from uncoded.ast_helpers import assign_target_name, property_kind
+from uncoded.read_helpers import _read_file_text_as_utf8
 
 def extract_module(source: str, rel_path: str) -> ModuleInfo:
     ...

uncoded-2.0.0/.uncoded/stubs/src/uncoded/read_helpers.pyi

@@ -0,0 +1,7 @@
+# src/uncoded/read_helpers.py
+
+import sys
+from pathlib import Path
+
+def _read_file_text_as_utf8(path: Path, *, display: Path | str | None) -> str | None:
+    ...

uncoded-2.0.0/.uncoded/stubs/src/uncoded/skill.pyi

@@ -0,0 +1,30 @@
+# src/uncoded/skill.py
+
+from dataclasses import dataclass
+from importlib.resources import files
+from pathlib import Path
+from typing import Literal
+import yaml
+from uncoded.sync import remove_file, sync_file
+
+SKILL_ROOTS = [Path('.claude/skills'), Path('.agents/skills')]
+SKILLS: list[Skill] = ...
+
+def _skill_path(root: Path, name: str) -> Path:
+    ...
+
+def _render_content(*, skill: Skill) -> str:
+    ...
+
+def _remove_skill_file(*, path: Path, project_root: Path, check: bool) -> bool:
+    ...
+
+def sync_skills(*, source: bool, docs: bool, project_root: Path, check: bool) -> int:
+    ...
+
+class Skill:
+    name: str
+    description: str
+    body_file: str
+    gate: Literal['code', 'docs']
+    legacy_names: tuple[str, ...] = ()