feat(sdk): add metadata source resolution and scope filtering - #311

Merged

dmealing merged 44 commits into

mainfrom

worktree-metadata-source-resolution-phase1

Aug 19, 2026

Commits on Aug 19, 2026

docs: metadata source resolution — prior art, design, and phase-1 plan

dmealing
and
claude
committed
3090a9a
feat(metadata): register phase-1 source-resolution error codes across all ports

dmealing
and
claude
committed
fc13abc
feat(sdk): package-pattern scope engine (* = one segment, ** = one or more)

dmealing
and
claude
committed
2ff8a1d
test(conformance): scope-pattern corpus pins * and ** semantics cross-port

dmealing
and
claude
committed
daf69ac
feat(sdk): resolve a source SET to a canonically-sorted file list

dmealing
and
claude
committed
b650ae1
fix(sdk): make the overlapping-file spec attribution order-independent

dmealing
and
claude
committed
cb08e94
feat(sdk): config accepts a source SET, a scope block, and migrate.scope

dmealing
and
claude
committed
de92960
fix(sdk): restore .strict() on SourceSpecSchema arms; fail closed on typos

dmealing
and
claude
committed
e32febb
feat(sdk): nearest-ancestor config discovery, bounded by the repo root

dmealing
and
claude
committed
9be8d35
feat(sdk): resolveCollection() — one authority for where metadata lives

dmealing
and
claude
committed
4300b7b
fix(sdk): resolveCollection propagates a malformed config, never swallows it

dmealing
and
claude
committed
6c6f8c0
test(sdk): pin order independence — permuted source sets serialize byte-identically

dmealing
and
claude
committed
4651484
fix(sdk): order-independence gate — assert content resolution, not sibling order

dmealing
and
claude
committed
814719e
fix(sdk): correctness fixes from code review — symlinks, scope patterns, error-code order, strict config, parity guard

dmealing
and
claude
committed
b3082e1
refactor(sdk): dedupe fileExists/CONFIG_FILE, thread config-existence boolean

dmealing
and
claude
committed
f496b1d
feat(sdk): loadMemory accepts an explicit resolved file set

dmealing
and
claude
committed
9200627
feat(cli): route gen/docs/export and the project probe through resolveCollection

dmealing
and
claude
committed
44a8bc5
test(cli): add sdk to ensureFreshDist gate

dmealing
and
claude
committed
833e430
fix(cli): detect-stack reads the resolved collection, fixing nested-symlink blindness

dmealing
and
claude
committed
218a29f
fix(metadata): add as const to error code array in typecheck test

dmealing
and
claude
committed
ad4695c
feat(cli): migrate.scope narrows both sides so unowned tables are never touched

dmealing
and
claude
committed
8375772
feat(codegen): collection scope filters generated output, and verify --codegen honours it

dmealing
and
claude
committed
dfb31c5
test(sdk): dogfood reach+scope against the in-repo examples metadata tree
dmealing
committed
9a95a58
test(scope-conformance): pin case-sensitive scope matching
dmealing
committed
0fc08d9
docs: metadata sources, scope, discovery, and the vendoring workflow
dmealing
committed
ceeae33
fix(sdk): resolved sources keep the loader's per-level walk order

dmealing
and
claude
committed
fece4e5
fix(migrate): a migrate.scope matching nothing no longer proposes DROP TABLE

dmealing
and
claude
committed
202ad65
fix(cli): route prompt-snapshot through resolveCollection; close two fail-open config blocks

dmealing
and
claude
committed
181d6bb
fix(cli): read per-project config from the resolved config dir, not ambient cwd

dmealing
and
claude
committed
0c8fd13
docs: an Upgrading section for the three adopter-visible changes

dmealing
and
claude
committed
5cbdeac
fix: the seven fix-before-merge minors from the whole-branch review

dmealing
and
claude
committed
e929bd8
refactor(cli): compute the snapshot gate's schema scope once

dmealing
and
claude
committed
5ee93a8
fix: nine correctness findings from the whole-branch quality pass

dmealing
and
claude
committed
bdef4fc
refactor: collapse the rules this branch enforced by repetition

dmealing
and
claude
committed
aab1bfa
test(cli): one fixture for the two migrate.scope integration suites

dmealing
and
claude
committed
ab6fc04
fix(cli): the docs-site theme is read where --scaffold-site writes it

dmealing
and
claude
committed
ce5724d
fix(sdk): the config is the only authority — at the walk and at the loader entry

dmealing
and
claude
committed
39678a7
fix(cli): what the CLI prints must not assert a directory the project may not have

dmealing
and
claude
committed
e550fd6
docs: state the rule where the next reader will meet it

dmealing
and
claude
committed
3c702ec
test(sdk): make "metaobjects/ is a config default" enforceable, not aspirational

dmealing
and
claude
committed
066fded
fix: two minors from the branch re-review

dmealing
and
claude
committed
d66b4e0
fix: close five residuals from the branch re-review

dmealing
and
claude
committed
8d2ffc6
no-mistakes(review): address stale changelog bullet and migrate scope provenance refusal
dmealing
committed
4baf19a
no-mistakes(document): Updated requirements.md to clarify metaobjects/ is default location
dmealing
committed
232a1af