@karmaniverous/stan-core 0.8.5 → 0.9.1

package/README.md

@@ -13,7 +13,6 @@ This package exposes the STAN engine as a library:
 - Config loading/validation (top‑level `stan-core` in stan.config.yml|json)
 - Imports staging under <stanPath>/imports/<label>/…
 - Imports safety: patch + File Ops refuse to modify <stanPath>/imports/\*\* when the correct stanPath is provided
-- Response‑format validator (optional)
 
 For the CLI and TTY runner, see @karmaniverous/stan-cli.
 
@@ -136,14 +135,6 @@ await prepareImports({
 });
 ```
 
-Validate assistant responses (optional utility):
-
-```ts
-import { validateResponseMessage } from '@karmaniverous/stan-core';
-const res = validateResponseMessage(replyBody);
-if (!res.ok) console.error(res.errors.join('\n'));
-```
-
 ## API surface
 
 Top‑level (via `import '@karmaniverous/stan-core'`):
@@ -153,7 +144,6 @@ Top‑level (via `import '@karmaniverous/stan-core'`):
 - Patch engine: `applyPatchPipeline`, `detectAndCleanPatch`, `executeFileOps`, `parseFileOpsBlock`
 - Imports: `prepareImports`
 - Config: `loadConfig`, `loadConfigSync`, `resolveStanPath`, `resolveStanPathSync`
-- Validation: `validateResponseMessage`
 
 See CHANGELOG for behavior changes. Typedoc site is generated from source.
 
@@ -168,13 +158,13 @@ Core file selection applies in this order:
 - `includes` are additive and can re-include paths ignored by `.gitignore`.
 - `excludes` are hard denials and override `includes`.
 
-## Meta archive (context-mode thread opener)
+## Meta archive (context-mode thread opener; written as archive.tar)
 
-When dependency graph mode is enabled, the engine can create a small `archive.meta.tar` (via `createMetaArchive`) intended as a thread opener:
+When dependency graph mode is enabled, the engine can create a small “meta archive” (via `createMetaArchive`) intended as a thread opener. In `stan run --context --meta`, the host writes this archive as `archive.tar` (and does not write a diff archive).
 
 - Includes `<stanPath>/system/**` (excluding `<stanPath>/system/.docs.meta.json`)
 - Includes `<stanPath>/context/dependency.meta.json` (required)
-- Omits `<stanPath>/context/dependency.state.json` always (clean slate for selections)
+- Includes `<stanPath>/context/dependency.state.json` (v2) when present (the host writes `{ "v": 2, "i": [] }` before archiving for a clean-slate selection)
 - Includes repo-root (top-level) base files selected by current selection config
 - Optionally includes `<stanPath>/output/**` when `includeOutputDir: true` (combine mode); archive files are still excluded by tar filter
 - Excludes staged payloads under `<stanPath>/context/{npm,abs}/**` by omission