ctxr-cli 0.5.0 → 0.7.0

package/dist/core/json-config-merge.js

@@ -5,19 +5,42 @@ import { writeFileAtomic } from './fs/atomic.js';
 function isHookEntryList(value) {
     return value.length > 0 && typeof value[0] === 'object' && value[0] !== null;
 }
+/** The filename a hook entry's command invokes, independent of the absolute path it's rooted at. */
+function hookCommandBasename(entry) {
+    const command = entry.hooks[0]?.command;
+    return command ? path.basename(command) : '';
+}
 /**
  * Upserts each incoming hook-matcher entry into the existing list, matched
- * by its own `hooks[0].command` (the path to contexture's generated
- * script): replaced in place when found, so regeneration is idempotent,
- * appended otherwise. Any entry with a different command — an operator's
- * own hook — is left untouched.
+ * by `(matcher, hookCommandBasename)` rather than the full command string —
+ * deliberately blind to the absolute path prefix, since that prefix is
+ * whichever checkout most recently generated it (typically a session
+ * worktree) and so is not stable across runs even for the SAME logical
+ * rule (stabilize-write-gate-hook-path). The first matching existing entry
+ * is replaced in place (preserving its position, so an unrelated
+ * hand-added entry elsewhere in the array is never reordered); any further
+ * entries that also match are dropped, so a list that has already
+ * accumulated more than one stale copy of contexture's own entry (e.g. one
+ * per session worktree that ever regenerated it) converges to exactly one
+ * on this run, not just on a version bump. An entry with a different
+ * matcher or a different script basename — an operator's own hook — is
+ * always left untouched.
  */
 function mergeHookEntries(existing, incoming) {
     let result = [...existing];
     for (const entry of incoming) {
-        const command = entry.hooks[0]?.command;
-        const index = result.findIndex((candidate) => candidate.hooks?.[0]?.command === command);
-        result = index === -1 ? [...result, entry] : result.map((candidate, i) => (i === index ? entry : candidate));
+        const isSameHook = (candidate) => candidate.matcher === entry.matcher && hookCommandBasename(candidate) === hookCommandBasename(entry);
+        let inserted = false;
+        result = result.flatMap((candidate) => {
+            if (!isSameHook(candidate))
+                return [candidate];
+            if (inserted)
+                return []; // a further stale duplicate of the same rule — drop it
+            inserted = true;
+            return [entry]; // replace the first match in place
+        });
+        if (!inserted)
+            result = [...result, entry];
     }
     return result;
 }

package/dist/core/json-config-merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-config-merge.js","sourceRoot":"","sources":["../../src/core/json-config-merge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json-config-merge.js","sourceRoot":"","sources":["../../src/core/json-config-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAajD,SAAS,eAAe,CAAC,KAAqB;IAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAC/E,CAAC;AAED,oGAAoG;AACpG,SAAS,mBAAmB,CAAC,KAAuB;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IACxC,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,gBAAgB,CAAC,QAAqC,EAAE,QAAqC;IACpG,IAAI,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,CAAC,SAA2B,EAAW,EAAE,CAC1D,SAAS,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,KAAK,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACvG,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YACpC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,QAAQ;gBAAE,OAAO,EAAE,CAAC,CAAC,uDAAuD;YAChF,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mCAAmC;QACrD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ;YAAE,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,KAAiB,EACjB,OAAkC;IAElC,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAC;IACrF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAE9E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,WAAW,GAAI,MAAM,CAAC,MAAM,CAAyC,IAAI,EAAE,CAAC;QAClF,MAAM,SAAS,GAA4B,EAAE,GAAG,WAAW,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAErF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,mBAAmB,CAAC,CAAC,CAAE,WAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;YAE3E,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,YAAY,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACnG,SAAS,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,YAAkC,EAAE,SAAwC,CAAC,CAAC;gBACpH,SAAS;YACX,CAAC;YAED,MAAM,eAAe,GAAG,YAAwB,CAAC;YACjD,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAChF,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAI,SAA+B,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5F,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC,CAAC;YAE/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;qBAAM,IAAI,mBAAmB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC/D,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC1B,CAAC;gBACD,SAAS;YACX,CAAC;YACD,SAAS,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;QAC9B,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,eAAe,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/migrations/add-explanation-craft-skill.d.ts

@@ -0,0 +1,26 @@
+import type { Migration } from './types.js';
+/**
+ * vendor-explanation-craft-skill: the shipped vendored set grew a second craft
+ * skill, and `init` writes the RESOLVED list into `contexture.yaml` while
+ * `reconcileStore` never rewrites configuration. So a change to the shipped
+ * default reaches new stores only; without this migration every store already
+ * on disk would keep a one-entry list and silently never receive the skill the
+ * publish skill now tells it to load.
+ *
+ * The uncomfortable part, stated rather than implied: `config/schema.ts` says
+ * the schema version bumps "only on a genuinely incompatible change, never on
+ * an additive one," and adding a skill is additive. This bumps it anyway, which
+ * means every existing store reports as needing `ctxr migrate` because a skill
+ * was added. That was the accepted price of guaranteed propagation — the
+ * alternatives were leaving the shipped default a lie for every store predating
+ * it, or an update-time nag that would never stop firing in a store that
+ * deliberately opted out. Do not read this as license to bump the version for
+ * the next additive change; weigh that one on its own.
+ *
+ * Pending-ness is the recorded schema version, never the list's contents — the
+ * rule 0002, 0004, 0005, and 0006 all follow, because the config schema fills
+ * `skills.vendored` from the shipped default when the key is absent, so an
+ * unmigrated store already reads as though it declared the new set.
+ */
+export declare const addExplanationCraftSkillMigration: Migration;
+//# sourceMappingURL=add-explanation-craft-skill.d.ts.map

package/dist/core/migrations/add-explanation-craft-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-explanation-craft-skill.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/add-explanation-craft-skill.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AA6C5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iCAAiC,EAAE,SA8B/C,CAAC"}

package/dist/core/migrations/add-explanation-craft-skill.js

@@ -0,0 +1,94 @@
+import path from 'node:path';
+import { DEFAULT_VENDORED_SKILLS } from '../../config/defaults.js';
+import { readConfig } from '../../config/load.js';
+import { renderStoreConfig } from '../../config/render.js';
+import { writeFileAtomic } from '../fs/atomic.js';
+/**
+ * The shipped set as it stood before this change — a fixed historical literal,
+ * never derived from `DEFAULT_VENDORED_SKILLS`. Deriving it would make the
+ * "was this list ever customized?" test drift every time the shipped set grows
+ * again, silently re-adding to lists a later operator had curated.
+ */
+const PREVIOUS_SHIPPED_SET = ['frontend-design'];
+const SCHEMA_VERSION = 7;
+function configDelta(next) {
+    return {
+        path: 'contexture.yaml',
+        description: `set skills.vendored to [${next.join(', ')}] and schema_version to ${SCHEMA_VERSION}`,
+    };
+}
+function versionOnlyDelta() {
+    return {
+        path: 'contexture.yaml',
+        description: `set schema_version to ${SCHEMA_VERSION}, leaving this store's own skills.vendored list untouched`,
+    };
+}
+/**
+ * The list to write, or undefined when this store's is not ours to rewrite.
+ *
+ * The heuristic 0004 and 0006 both used: a list still sitting exactly on the
+ * previous shipped default was never curated, so growing it matches what the
+ * operator already accepted. A list that was reordered, added to, or emptied to
+ * opt out is a decision, and re-adding to it would overwrite that decision —
+ * such a store gets the version bump alone.
+ */
+function nextVendoredList(current) {
+    const unchanged = current.length === PREVIOUS_SHIPPED_SET.length && current.every((name, i) => name === PREVIOUS_SHIPPED_SET[i]);
+    if (!unchanged)
+        return undefined;
+    const shipped = [...DEFAULT_VENDORED_SKILLS];
+    const added = shipped.filter((name) => !current.includes(name));
+    return added.length > 0 ? shipped : undefined;
+}
+/**
+ * vendor-explanation-craft-skill: the shipped vendored set grew a second craft
+ * skill, and `init` writes the RESOLVED list into `contexture.yaml` while
+ * `reconcileStore` never rewrites configuration. So a change to the shipped
+ * default reaches new stores only; without this migration every store already
+ * on disk would keep a one-entry list and silently never receive the skill the
+ * publish skill now tells it to load.
+ *
+ * The uncomfortable part, stated rather than implied: `config/schema.ts` says
+ * the schema version bumps "only on a genuinely incompatible change, never on
+ * an additive one," and adding a skill is additive. This bumps it anyway, which
+ * means every existing store reports as needing `ctxr migrate` because a skill
+ * was added. That was the accepted price of guaranteed propagation — the
+ * alternatives were leaving the shipped default a lie for every store predating
+ * it, or an update-time nag that would never stop firing in a store that
+ * deliberately opted out. Do not read this as license to bump the version for
+ * the next additive change; weigh that one on its own.
+ *
+ * Pending-ness is the recorded schema version, never the list's contents — the
+ * rule 0002, 0004, 0005, and 0006 all follow, because the config schema fills
+ * `skills.vendored` from the shipped default when the key is absent, so an
+ * unmigrated store already reads as though it declared the new set.
+ */
+export const addExplanationCraftSkillMigration = {
+    id: '0007-add-explanation-craft-skill',
+    fromVersion: 6,
+    toVersion: SCHEMA_VERSION,
+    description: `Add the explanation craft skill to a store whose skills.vendored list still sits at the previous shipped default, and bump schema_version to ${SCHEMA_VERSION}.`,
+    async plan(store) {
+        if (store.config.schema_version >= SCHEMA_VERSION)
+            return [];
+        const next = nextVendoredList(store.config.skills.vendored);
+        return [next ? configDelta(next) : versionOnlyDelta()];
+    },
+    async apply(store) {
+        if (store.config.schema_version >= SCHEMA_VERSION)
+            return [];
+        // Re-read from disk rather than trusting the store snapshot: an interrupted
+        // run may have written the config already, and resumability means deciding
+        // from current state.
+        const currentConfig = await readConfig(store.root);
+        const next = nextVendoredList(currentConfig.skills.vendored);
+        const nextConfig = {
+            ...currentConfig,
+            schema_version: SCHEMA_VERSION,
+            skills: { ...currentConfig.skills, vendored: next ?? currentConfig.skills.vendored },
+        };
+        await writeFileAtomic(path.join(store.root, 'contexture.yaml'), renderStoreConfig(nextConfig));
+        return [next ? configDelta(next) : versionOnlyDelta()];
+    },
+};
+//# sourceMappingURL=add-explanation-craft-skill.js.map

package/dist/core/migrations/add-explanation-craft-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-explanation-craft-skill.js","sourceRoot":"","sources":["../../../src/core/migrations/add-explanation-craft-skill.ts"],"names":[],"mappings":"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"}

package/dist/core/migrations/archive-destination-from-taxonomy.d.ts

@@ -0,0 +1,35 @@
+import type { Migration } from './types.js';
+/**
+ * archive-destination-from-taxonomy: `ctxr init` wrote a fixed
+ * `DEFAULT_ARCHIVE_PATH` regardless of the taxonomy it had just resolved, so
+ * every PARA store was born with `archive/` while its own taxonomy declared
+ * `archives/` — a config key pointing at a directory the store does not have.
+ * Init now asks the profile; this migration does the same for stores already
+ * on disk.
+ *
+ * Two independent halves, and the second is conditional:
+ *
+ * 1. The key rename is unconditional — every schema-5 store gets
+ *    `archive_destination`. `OrganizeSchema`'s fallback transform has already
+ *    resolved the old spelling by the time `readConfig` returns, so writing
+ *    the parsed config back is what drops `archive_path` from disk.
+ * 2. The value only changes when the store never customized it AND its
+ *    profile declares a destination of its own. An operator who deliberately
+ *    set some other path keeps it; a Zettelkasten or Diataxis store, whose
+ *    profile declares none, keeps `archive/` — for them this is a pure key
+ *    rename. A custom taxonomy resolves to no shipped profile and is left
+ *    alone for the same reason.
+ *
+ * Like 0004, the directory move is a plain filesystem rename (migrations see
+ * only `Store` — `root` + `config`, no `GitRunner`), and it is skipped when
+ * the old directory was never created. History survives either way: whatever
+ * commits this output stages a coherent delete-old/add-new diff, which
+ * `git log --follow`'s rename detection reads identically to a `git mv`.
+ *
+ * Pending-ness is `schema_version < 6`, not key presence — the rule 0002,
+ * 0004, and 0005 established, for the same reason: the fallback transform
+ * populates `archive_destination` on an unmigrated store too, so its presence
+ * cannot distinguish migrated from not.
+ */
+export declare const archiveDestinationFromTaxonomyMigration: Migration;
+//# sourceMappingURL=archive-destination-from-taxonomy.d.ts.map

package/dist/core/migrations/archive-destination-from-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-destination-from-taxonomy.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/archive-destination-from-taxonomy.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAc5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,uCAAuC,EAAE,SA4CrD,CAAC"}

package/dist/core/migrations/archive-destination-from-taxonomy.js

@@ -0,0 +1,109 @@
+import { existsSync } from 'node:fs';
+import { rename } from 'node:fs/promises';
+import path from 'node:path';
+import { readConfig } from '../../config/load.js';
+import { DEFAULT_ARCHIVE_DESTINATION } from '../../config/defaults.js';
+import { renderStoreConfig } from '../../config/render.js';
+import { profileById } from '../../taxonomy/profiles.js';
+import { writeFileAtomic } from '../fs/atomic.js';
+const CONFIG_DELTA = {
+    path: 'contexture.yaml',
+    description: 'rename organize.archive_path to organize.archive_destination and set schema_version to 6',
+};
+function destinationDelta(from, to) {
+    return {
+        path: to,
+        description: `adopt the taxonomy's own archive destination, moving the default-valued archive directory from ${from} to ${to}`,
+    };
+}
+/**
+ * archive-destination-from-taxonomy: `ctxr init` wrote a fixed
+ * `DEFAULT_ARCHIVE_PATH` regardless of the taxonomy it had just resolved, so
+ * every PARA store was born with `archive/` while its own taxonomy declared
+ * `archives/` — a config key pointing at a directory the store does not have.
+ * Init now asks the profile; this migration does the same for stores already
+ * on disk.
+ *
+ * Two independent halves, and the second is conditional:
+ *
+ * 1. The key rename is unconditional — every schema-5 store gets
+ *    `archive_destination`. `OrganizeSchema`'s fallback transform has already
+ *    resolved the old spelling by the time `readConfig` returns, so writing
+ *    the parsed config back is what drops `archive_path` from disk.
+ * 2. The value only changes when the store never customized it AND its
+ *    profile declares a destination of its own. An operator who deliberately
+ *    set some other path keeps it; a Zettelkasten or Diataxis store, whose
+ *    profile declares none, keeps `archive/` — for them this is a pure key
+ *    rename. A custom taxonomy resolves to no shipped profile and is left
+ *    alone for the same reason.
+ *
+ * Like 0004, the directory move is a plain filesystem rename (migrations see
+ * only `Store` — `root` + `config`, no `GitRunner`), and it is skipped when
+ * the old directory was never created. History survives either way: whatever
+ * commits this output stages a coherent delete-old/add-new diff, which
+ * `git log --follow`'s rename detection reads identically to a `git mv`.
+ *
+ * Pending-ness is `schema_version < 6`, not key presence — the rule 0002,
+ * 0004, and 0005 established, for the same reason: the fallback transform
+ * populates `archive_destination` on an unmigrated store too, so its presence
+ * cannot distinguish migrated from not.
+ */
+export const archiveDestinationFromTaxonomyMigration = {
+    id: '0006-archive-destination-from-taxonomy',
+    fromVersion: 5,
+    toVersion: 6,
+    description: "Rename the organize.archive_path config key to organize.archive_destination, adopt the taxonomy profile's own archive destination when the value still sat at the shipped default, and bump schema_version to 6.",
+    async plan(store) {
+        if (store.config.schema_version >= 6)
+            return [];
+        const deltas = [CONFIG_DELTA];
+        const target = taxonomyDestination(store.config.taxonomy.profile, store.config.organize.archive_destination);
+        if (target)
+            deltas.push(destinationDelta(DEFAULT_ARCHIVE_DESTINATION, target));
+        return deltas;
+    },
+    async apply(store) {
+        if (store.config.schema_version >= 6)
+            return [];
+        const configPath = path.join(store.root, 'contexture.yaml');
+        const currentConfig = await readConfig(store.root);
+        const appliedDeltas = [CONFIG_DELTA];
+        let destination = currentConfig.organize.archive_destination;
+        const target = taxonomyDestination(currentConfig.taxonomy.profile, destination);
+        if (target) {
+            const oldDir = path.join(store.root, DEFAULT_ARCHIVE_DESTINATION);
+            const newDir = path.join(store.root, target);
+            // Absent whenever nothing was ever archived — only the config changes.
+            if (existsSync(oldDir) && !existsSync(newDir)) {
+                await rename(oldDir, newDir);
+            }
+            destination = target;
+            appliedDeltas.push(destinationDelta(DEFAULT_ARCHIVE_DESTINATION, target));
+        }
+        const nextConfig = {
+            ...currentConfig,
+            schema_version: 6,
+            organize: { ...currentConfig.organize, archive_destination: destination },
+        };
+        await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
+        return appliedDeltas;
+    },
+};
+/**
+ * The profile's own destination, but only when adopting it is safe: the
+ * store must still be sitting on the shipped default (otherwise the value is
+ * the operator's, not ours to rewrite), the profile must be a shipped one
+ * that declares a destination, and it must actually differ from what's
+ * already configured.
+ */
+function taxonomyDestination(profileId, current) {
+    if (current !== DEFAULT_ARCHIVE_DESTINATION)
+        return undefined;
+    if (profileId === null)
+        return undefined;
+    const declared = profileById(profileId)?.archiveDestination;
+    if (declared === undefined || declared === current)
+        return undefined;
+    return declared;
+}
+//# sourceMappingURL=archive-destination-from-taxonomy.js.map

package/dist/core/migrations/archive-destination-from-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-destination-from-taxonomy.js","sourceRoot":"","sources":["../../../src/core/migrations/archive-destination-from-taxonomy.ts"],"names":[],"mappings":"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"}

package/dist/core/migrations/drop-access-axes.d.ts

@@ -0,0 +1,24 @@
+import type { Migration } from './types.js';
+/**
+ * retire-the-access-axes: the visibility and disclosure axes are removed, and
+ * with them `fields.visibility` (the configurable name of the visibility
+ * frontmatter key).
+ *
+ * Unlike 0005, this migration cannot lean on `readConfig` having already
+ * stripped the legacy shape: all three keys are TOP-LEVEL, and
+ * `StoreConfigSchema` is `.passthrough()`, so they survive parsing intact.
+ * Deleting them explicitly is the whole job.
+ *
+ * No note is rewritten (design.md D3). A note's retired visibility-field key
+ * stays in its frontmatter, unread — `parseNote` reads frontmatter into a
+ * `Record<string, unknown>` and nothing consumes that key any more, so it
+ * costs nothing at runtime and keeps the removal cheap to reverse. Stripping
+ * it would make re-entry a hand re-labelling pass over every note.
+ *
+ * Pending-ness is `schema_version < 8`, not key presence — the rule every
+ * migration from 0002 onward established. A store could have had its config
+ * hand-edited to drop the keys while still sitting at an older version, and
+ * it still needs the version bump.
+ */
+export declare const dropAccessAxesMigration: Migration;
+//# sourceMappingURL=drop-access-axes.d.ts.map

package/dist/core/migrations/drop-access-axes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-access-axes.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/drop-access-axes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAU5D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAuBrC,CAAC"}

package/dist/core/migrations/drop-access-axes.js

@@ -0,0 +1,54 @@
+import path from 'node:path';
+import { readConfig } from '../../config/load.js';
+import { renderStoreConfig } from '../../config/render.js';
+import { writeFileAtomic } from '../fs/atomic.js';
+const CONFIG_DELTA = {
+    path: 'contexture.yaml',
+    description: 'remove the visibility:, disclosure:, and fields: blocks, and set schema_version to 8',
+};
+/** The retired top-level keys, named here as fixed historical literals — no constant for them survives. */
+const RETIRED_KEYS = ['visibility', 'disclosure', 'fields'];
+/**
+ * retire-the-access-axes: the visibility and disclosure axes are removed, and
+ * with them `fields.visibility` (the configurable name of the visibility
+ * frontmatter key).
+ *
+ * Unlike 0005, this migration cannot lean on `readConfig` having already
+ * stripped the legacy shape: all three keys are TOP-LEVEL, and
+ * `StoreConfigSchema` is `.passthrough()`, so they survive parsing intact.
+ * Deleting them explicitly is the whole job.
+ *
+ * No note is rewritten (design.md D3). A note's retired visibility-field key
+ * stays in its frontmatter, unread — `parseNote` reads frontmatter into a
+ * `Record<string, unknown>` and nothing consumes that key any more, so it
+ * costs nothing at runtime and keeps the removal cheap to reverse. Stripping
+ * it would make re-entry a hand re-labelling pass over every note.
+ *
+ * Pending-ness is `schema_version < 8`, not key presence — the rule every
+ * migration from 0002 onward established. A store could have had its config
+ * hand-edited to drop the keys while still sitting at an older version, and
+ * it still needs the version bump.
+ */
+export const dropAccessAxesMigration = {
+    id: '0008-drop-access-axes',
+    fromVersion: 7,
+    toVersion: 8,
+    description: 'Remove the visibility:, disclosure:, and fields: blocks from contexture.yaml, and bump schema_version to 8. No note is modified.',
+    async plan(store) {
+        if (store.config.schema_version >= 8)
+            return [];
+        return [CONFIG_DELTA];
+    },
+    async apply(store) {
+        if (store.config.schema_version >= 8)
+            return [];
+        const configPath = path.join(store.root, 'contexture.yaml');
+        const currentConfig = await readConfig(store.root);
+        const nextConfig = { ...currentConfig, schema_version: 8 };
+        for (const key of RETIRED_KEYS)
+            delete nextConfig[key];
+        await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
+        return [CONFIG_DELTA];
+    },
+};
+//# sourceMappingURL=drop-access-axes.js.map

package/dist/core/migrations/drop-access-axes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-access-axes.js","sourceRoot":"","sources":["../../../src/core/migrations/drop-access-axes.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,sFAAsF;CACpG,CAAC;AAEF,2GAA2G;AAC3G,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAc;IAChD,EAAE,EAAE,uBAAuB;IAC3B,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EACT,kIAAkI;IAEpI,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAChD,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAK;QACf,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAA4B,EAAE,GAAG,aAAa,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QACpF,KAAK,MAAM,GAAG,IAAI,YAAY;YAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,UAAqD,CAAC,CAAC,CAAC;QAE5G,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;CACF,CAAC"}

package/dist/core/migrations/drop-forge-and-workspaces-external.d.ts

@@ -0,0 +1,19 @@
+import type { Migration } from './types.js';
+/**
+ * session-keeps-only-what-git-cannot-do (design D2): `ctxr session
+ * submit`/`land`/`abandon`/`reap` and the `forge` adapter kind are removed;
+ * `session.workspaces_external` goes with them, its skill-rendering half
+ * never having worked as shipped. Both legacy shapes are ALREADY stripped
+ * by the time `readConfig` returns — the adapters field's lenient schema
+ * transform drops a `kind: forge` entry (session-keeps-only-what-git-cannot-do
+ * D2), and `SessionSchema`'s default strip-unknown-keys behavior drops
+ * `workspaces_external` — so this migration's only real work is bumping
+ * `schema_version` and writing the already-clean config back to disk.
+ *
+ * Pending-ness is `schema_version < 5`, not key presence — the same rule
+ * 0002 and 0004 established, for the same reason: an unmigrated store
+ * already parses as though the legacy shape were gone, so its presence in
+ * the parsed config can't distinguish migrated from not.
+ */
+export declare const dropForgeAndWorkspacesExternalMigration: Migration;
+//# sourceMappingURL=drop-forge-and-workspaces-external.d.ts.map

package/dist/core/migrations/drop-forge-and-workspaces-external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-forge-and-workspaces-external.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/drop-forge-and-workspaces-external.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAO5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uCAAuC,EAAE,SA0BrD,CAAC"}

package/dist/core/migrations/drop-forge-and-workspaces-external.js

@@ -0,0 +1,49 @@
+import path from 'node:path';
+import { readConfig } from '../../config/load.js';
+import { renderStoreConfig } from '../../config/render.js';
+import { writeFileAtomic } from '../fs/atomic.js';
+const CONFIG_DELTA = {
+    path: 'contexture.yaml',
+    description: 'strip any legacy kind: forge adapter declarations and the session.workspaces_external key, and set schema_version to 5',
+};
+/**
+ * session-keeps-only-what-git-cannot-do (design D2): `ctxr session
+ * submit`/`land`/`abandon`/`reap` and the `forge` adapter kind are removed;
+ * `session.workspaces_external` goes with them, its skill-rendering half
+ * never having worked as shipped. Both legacy shapes are ALREADY stripped
+ * by the time `readConfig` returns — the adapters field's lenient schema
+ * transform drops a `kind: forge` entry (session-keeps-only-what-git-cannot-do
+ * D2), and `SessionSchema`'s default strip-unknown-keys behavior drops
+ * `workspaces_external` — so this migration's only real work is bumping
+ * `schema_version` and writing the already-clean config back to disk.
+ *
+ * Pending-ness is `schema_version < 5`, not key presence — the same rule
+ * 0002 and 0004 established, for the same reason: an unmigrated store
+ * already parses as though the legacy shape were gone, so its presence in
+ * the parsed config can't distinguish migrated from not.
+ */
+export const dropForgeAndWorkspacesExternalMigration = {
+    id: '0005-drop-forge-and-workspaces-external',
+    fromVersion: 4,
+    toVersion: 5,
+    description: 'Strip any legacy kind: forge adapter declarations and the session.workspaces_external key from contexture.yaml, and bump schema_version to 5.',
+    async plan(store) {
+        if (store.config.schema_version >= 5)
+            return [];
+        return [CONFIG_DELTA];
+    },
+    async apply(store) {
+        if (store.config.schema_version >= 5)
+            return [];
+        const configPath = path.join(store.root, 'contexture.yaml');
+        // readConfig() already applies the lenient schema — a raw `kind: forge`
+        // entry and a raw `session.workspaces_external` key are both gone from
+        // this object before this line runs; writing it back is what removes
+        // them from disk.
+        const currentConfig = await readConfig(store.root);
+        const nextConfig = { ...currentConfig, schema_version: 5 };
+        await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
+        return [CONFIG_DELTA];
+    },
+};
+//# sourceMappingURL=drop-forge-and-workspaces-external.js.map

package/dist/core/migrations/drop-forge-and-workspaces-external.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-forge-and-workspaces-external.js","sourceRoot":"","sources":["../../../src/core/migrations/drop-forge-and-workspaces-external.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,wHAAwH;CACtI,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAc;IAChE,EAAE,EAAE,yCAAyC;IAC7C,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EACT,+IAA+I;IAEjJ,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAChD,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAK;QACf,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC5D,wEAAwE;QACxE,uEAAuE;QACvE,qEAAqE;QACrE,kBAAkB;QAClB,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,EAAE,GAAG,aAAa,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjE,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;CACF,CAAC"}

package/dist/core/migrations/registry.d.ts

@@ -1,5 +1,15 @@
 import type { Migration } from './types.js';
-/** Every migration contexture ships, in ascending fromVersion order. Later phases append here, nothing else. */
+/**
+ * Every migration contexture ships, in ascending fromVersion order. Later
+ * phases append here, nothing else.
+ *
+ * The chain is deliberately NOT contiguous: the 1 -> 2 visibility-field
+ * rename was retired with the field itself (retire-the-access-axes D7), so a
+ * schema-1 store's first pending migration is the 2 -> 3 one, which guards on
+ * `schema_version < 3` and carries it straight there. `pendingMigrations`
+ * selects on `fromVersion >= current`, never on adjacency, so a gap costs
+ * nothing.
+ */
 export declare const MIGRATIONS: readonly Migration[];
 /** Every migration a store currently at `fromVersion` still needs to reach the CLI's supported version, in order. */
 export declare function pendingMigrations(fromVersion: number): Migration[];

package/dist/core/migrations/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,gHAAgH;AAChH,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAI1C,CAAC;AAEF,qHAAqH;AACrH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAElE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAO1C,CAAC;AAEF,qHAAqH;AACrH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAElE"}

package/dist/core/migrations/registry.js

@@ -1,11 +1,27 @@
+import { addExplanationCraftSkillMigration } from './add-explanation-craft-skill.js';
+import { archiveDestinationFromTaxonomyMigration } from './archive-destination-from-taxonomy.js';
+import { dropAccessAxesMigration } from './drop-access-axes.js';
+import { dropForgeAndWorkspacesExternalMigration } from './drop-forge-and-workspaces-external.js';
 import { renameConventionsPathMigration } from './rename-conventions-path.js';
 import { renameProceduresPathMigration } from './rename-procedures-path.js';
-import { renameVisibilityFieldMigration } from './rename-visibility-field.js';
-/** Every migration contexture ships, in ascending fromVersion order. Later phases append here, nothing else. */
+/**
+ * Every migration contexture ships, in ascending fromVersion order. Later
+ * phases append here, nothing else.
+ *
+ * The chain is deliberately NOT contiguous: the 1 -> 2 visibility-field
+ * rename was retired with the field itself (retire-the-access-axes D7), so a
+ * schema-1 store's first pending migration is the 2 -> 3 one, which guards on
+ * `schema_version < 3` and carries it straight there. `pendingMigrations`
+ * selects on `fromVersion >= current`, never on adjacency, so a gap costs
+ * nothing.
+ */
 export const MIGRATIONS = [
-    renameVisibilityFieldMigration,
     renameProceduresPathMigration,
     renameConventionsPathMigration,
+    dropForgeAndWorkspacesExternalMigration,
+    archiveDestinationFromTaxonomyMigration,
+    addExplanationCraftSkillMigration,
+    dropAccessAxesMigration,
 ];
 /** Every migration a store currently at `fromVersion` still needs to reach the CLI's supported version, in order. */
 export function pendingMigrations(fromVersion) {

package/dist/core/migrations/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAG9E,gHAAgH;AAChH,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,8BAA8B;IAC9B,6BAA6B;IAC7B,8BAA8B;CAC/B,CAAC;AAEF,qHAAqH;AACrH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACtH,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/migrations/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EAAE,uCAAuC,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,uCAAuC,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAG5E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,6BAA6B;IAC7B,8BAA8B;IAC9B,uCAAuC;IACvC,uCAAuC;IACvC,iCAAiC;IACjC,uBAAuB;CACxB,CAAC;AAEF,qHAAqH;AACrH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACtH,CAAC"}

package/dist/core/notes/list.d.ts

@@ -1,17 +1,6 @@
 import type { StoreConfig } from '../../config/schema.js';
-/**
- * The note-enumeration seam every later retrieval leg builds on. `as` is
- * accepted (and, until Phase 5, ignored) from Phase 0 — a real finding:
- * openspec/config.yaml's own authoring rule says "sequence visibility
- * enforcement before retrieval — a pre-filter cannot be safely retrofitted
- * from a post-filter," but tasks.md's phase order puts retrieval (Phase 3/4)
- * before visibility enforcement (Phase 5). Accepting `as` here from the
- * start means Phase 5 wires a real filter into an already-filterable
- * signature, instead of auditing every earlier traversal for safety.
- */
+/** The note-enumeration seam every retrieval leg builds on. */
 export interface NoteQuery {
-    /** The requesting context, for visibility filtering. Wired in Phase 5. */
-    as?: string;
     underPrefix?: string;
 }
 export interface Note {

package/dist/core/notes/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/core/notes/list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAsCD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAUjE;AAkCD,wGAAwG;AACxG,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAO9G"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/core/notes/list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AA0CD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAYjE;AAkCD,wGAAwG;AACxG,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAO9G"}