@noir-ai/core 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agaaaptr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @noir-ai/core
+
+Shared domain types, the configuration schema (`NoirConfigSchema`), the `.noir/` on-disk layout, and the marker constants that the rest of the Noir toolkit is built on. This is the type-contract package — it holds no runtime I/O of its own.
+
+Part of the **[Noir](https://github.com/agaaaptr/noir#readme)** toolkit — the discipline, context, and memory layer for any agentic CLI.
+
+## Install
+
+```bash
+npm install @noir-ai/core
+```
+
+> Most users install the CLI instead, which pulls in the packages it needs:
+>
+> ```bash
+> npm install -g @noir-ai/cli
+> ```
+
+This package is mainly consumed by the other `@noir-ai/*` packages. For programmatic usage, see the [root README](https://github.com/agaaaptr/noir#readme) and [`docs/usage.md`](https://github.com/agaaaptr/noir/blob/main/docs/usage.md).
+
+## License
+
+MIT © agaaaptr

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import * as z from 'zod';
+
+declare const NoirConfigSchema: z.ZodObject<{
+    host: z.ZodLiteral<"claude">;
+    name: z.ZodOptional<z.ZodString>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        full: "full";
+        quick: "quick";
+    }>>;
+    daemon: z.ZodDefault<z.ZodObject<{
+        idleTimeoutSec: z.ZodDefault<z.ZodNumber>;
+        port: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    context: z.ZodDefault<z.ZodObject<{
+        embedder: z.ZodDefault<z.ZodObject<{
+            kind: z.ZodDefault<z.ZodEnum<{
+                local: "local";
+                remote: "remote";
+                ollama: "ollama";
+                none: "none";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+            provider: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            dim: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        roots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        budgetTokens: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    model: z.ZodDefault<z.ZodObject<{
+        defaultProvider: z.ZodOptional<z.ZodString>;
+        tiers: z.ZodOptional<z.ZodObject<{
+            draft: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            summarize: z.ZodOptional<z.ZodString>;
+            consolidate: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            model: z.ZodString;
+            baseURL: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    memory: z.ZodDefault<z.ZodObject<{
+        consolidation: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type NoirConfig = z.infer<typeof NoirConfigSchema>;
+declare function parseConfig(raw: unknown): NoirConfig;
+
+declare const NOIR_DIR = ".noir";
+/**
+ * User-global Noir home: `~/.noir` (HOME-relative, NOT project `.noir/`).
+ *
+ * Hosts cross-project, user-scoped state — today the daemon record
+ * (`~/.noir/daemon.json`, written by @noir-ai/daemon) and the embedding-model
+ * cache ({@link modelsDir}). Kept HOME-relative so a single project checkout
+ * stays portable across machines (blueprint: `ProjectId` is canonical, never a
+ * filesystem path; the project `.noir/` dir never holds machine-local caches).
+ */
+declare function noirHome(): string;
+/**
+ * User-global cache for downloaded embedding-model weights: `~/.noir/models/`.
+ *
+ * Used by @noir-ai/context's local embedder (`@huggingface/transformers` pins
+ * `env.cacheDir` here on first load). HOME-relative per spec OQ-7 (resolved) —
+ * the ~22 MB MiniLM download is user-scoped, not per-project, so projects stay
+ * portable and the weight is fetched at most once per machine.
+ */
+declare function modelsDir(): string;
+declare const paths: {
+    readonly noirDir: (root: string) => string;
+    readonly noirMd: (root: string) => string;
+    readonly config: (root: string) => string;
+    readonly projectId: (root: string) => string;
+    readonly storeDir: (root: string) => string;
+    readonly storeDb: (root: string, projectId: string) => string;
+    readonly specsDir: (root: string) => string;
+    readonly specFile: (root: string, taskId: string, slug: string) => string;
+    readonly plansDir: (root: string) => string;
+    readonly planFile: (root: string, taskId: string, slug: string) => string;
+    readonly tasksDir: (root: string) => string;
+    readonly taskFile: (root: string, taskId: string, taskName: string) => string;
+    readonly decisionsDir: (root: string) => string;
+    readonly decisionFile: (root: string, n: number) => string;
+    readonly auditDir: (root: string) => string;
+    readonly auditFile: (root: string, taskId: string) => string;
+};
+
+declare const CONTEXT_BLOCK_BEGIN = "<!-- noir:context begin -->";
+declare const CONTEXT_BLOCK_END = "<!-- noir:context end -->";
+
+/** Canonical, machine-stable project identity. NEVER a filesystem path. */
+type ProjectId = string;
+declare function createProjectId(): ProjectId;
+
+interface ProjectInfo {
+    id: ProjectId;
+    name: string;
+    root: string;
+    config: NoirConfig;
+}
+declare function loadProjectInfo(root: string): ProjectInfo;
+
+declare const NOIR_VERSION: string;
+
+export { CONTEXT_BLOCK_BEGIN, CONTEXT_BLOCK_END, NOIR_DIR, NOIR_VERSION, type NoirConfig, NoirConfigSchema, type ProjectId, type ProjectInfo, createProjectId, loadProjectInfo, modelsDir, noirHome, parseConfig, paths };

package/dist/index.js

@@ -0,0 +1,201 @@
+// src/config.ts
+import * as z from "zod";
+var NoirConfigSchema = z.object({
+  host: z.literal("claude"),
+  name: z.string().optional(),
+  mode: z.enum(["full", "quick"]).default("full"),
+  daemon: z.object({
+    idleTimeoutSec: z.number().int().positive().default(900),
+    port: z.number().int().min(0).max(65535).optional()
+  }).default({ idleTimeoutSec: 900 }),
+  // Slice S6 context layer (@noir-ai/context). Mirrors the `daemon` idiom — a
+  // top-level object with `.default({})` so a config with NO `context:` block
+  // still parses and behaves as local-embedder-attempted (AC-7 / NFR-6). The
+  // embedder shape is `kind`-based to match the discriminated `EmbedderConfig`
+  // the context factory consumes; `resolveEmbedderConfig` (@noir-ai/context) is
+  // the single bridge from this user-facing schema to the factory input, so core
+  // never imports context (no core→context cycle). Provider-explicit, NEVER
+  // silent remote (blueprint D6): `kind:'remote'`/`'ollama'` are opt-in only;
+  // the default `'local'` is in-process, offline, free, private.
+  context: z.object({
+    embedder: z.object({
+      kind: z.enum(["local", "remote", "ollama", "none"]).default("local"),
+      // HF repo id (local) / provider model id (remote) / Ollama tag.
+      model: z.string().optional(),
+      // Remote provider key, e.g. 'openai' (only meaningful when kind:'remote').
+      // Free-form string so openai-compatible providers stay expressible; the
+      // resolver maps known names (openai/voyage/cohere) to their API-key env var.
+      provider: z.string().optional(),
+      // Ollama base URL, e.g. http://localhost:11434 (only when kind:'ollama').
+      baseURL: z.string().optional(),
+      // Target dimensionality — must be 384 to match the existing vec0 table.
+      dim: z.number().int().positive().default(384)
+    }).default({ kind: "local", dim: 384 }),
+    // Configured index roots (informational in core; the daemon/indexer consume).
+    roots: z.array(z.string()).default([]),
+    // Default token budget for a `context_search` result set (retriever default).
+    budgetTokens: z.number().int().positive().default(4096)
+  }).default({ embedder: { kind: "local", dim: 384 }, roots: [], budgetTokens: 4096 }),
+  // Slice S8 bounded model layer (@noir-ai/model). Mirrors the `daemon` idiom —
+  // a top-level object with `.default({})` so a config with NO `model:` block
+  // still parses and behaves as fully-degraded (every `complete()` call returns
+  // `null`; callers substitute a template — the always-available offline path,
+  // blueprint D5 / DS-5). `resolveModelConfig` (@noir-ai/model) is the single
+  // bridge from this user-facing schema to the runtime shape `complete()`
+  // consumes, so core never imports model (no core→model cycle).
+  //
+  // Provider-EXPLICIT, never silent paid (blueprint D5 / DS-6): the provider is
+  // resolved ONLY from explicit `defaultProvider` / a tier's provider key. Env-
+  // var presence is NEVER consulted to pick a provider — `ANTHROPIC_API_KEY`
+  // being set for another tool does NOT activate Anthropic in Noir. No explicit,
+  // configured provider ⇒ `null`. Secrets live in env vars only (DS-8):
+  // `apiKeyEnv` stores the env-var NAME (`ANTHROPIC_API_KEY`), never the value,
+  // so `.noir/config.yml` stays safe to commit and share; `complete()` reads the
+  // value at call time. `tiers` map a tier name → provider block key; each
+  // `providers[name]` declares the model id, optional `baseURL` (openai-compat),
+  // and optional `apiKeyEnv` (omit for anonymous local providers like Ollama).
+  model: z.object({
+    // Fallback provider name (key into `providers`) when a call's tier resolves
+    // no explicit provider. Free-form string so openai-compatible providers stay
+    // expressible without an enum churn.
+    defaultProvider: z.string().optional(),
+    // Per-tier provider-key overrides (draft / title / summarize / consolidate).
+    // Each value is a key into `providers{}`; resolution is the consumer's job
+    // (tier → tier.provider → defaultProvider → providers[name]).
+    tiers: z.object({
+      draft: z.string().optional(),
+      title: z.string().optional(),
+      summarize: z.string().optional(),
+      consolidate: z.string().optional()
+    }).optional(),
+    // Configured provider blocks, keyed by name. `model` is required (a provider
+    // without a model id is meaningless); `apiKeyEnv` is omitted for anonymous
+    // local providers (Ollama / LM Studio) which then send no auth header.
+    providers: z.record(
+      z.string(),
+      z.object({
+        model: z.string(),
+        baseURL: z.string().optional(),
+        apiKeyEnv: z.string().optional()
+      })
+    ).optional()
+  }).default({}),
+  // Slice S7 cross-session memory (@noir-ai/memory). Mirrors the `daemon` idiom —
+  // a top-level object with `.default({})` so a config with NO `memory:` block
+  // still parses and behaves as consolidation-disabled (the safe default —
+  // capture/store/retrieve are always local + free; consolidation is the ONLY
+  // LLM touch and it is opt-in + provider-explicit). `resolveMemoryConfig`
+  // (@noir-ai/memory) is the single bridge from this user-facing schema to the
+  // runtime `MemoryConfig` the engine consumes, so core never imports memory
+  // (no core→memory cycle; mirrors @noir-ai/context + @noir-ai/model).
+  //
+  // Provider-EXPLICIT, never silent paid (blueprint D6 / DS-6): the provider is
+  // resolved ONLY from explicit `consolidation.provider`. Env-var presence is
+  // NEVER consulted to pick a provider — `ANTHROPIC_API_KEY` being set for
+  // another tool does NOT activate consolidation. No explicit, enabled provider
+  // ⇒ `runConsolidation` refuses with `'no-provider'` + writes a miss audit, and
+  // NO S8 `complete()` call is made (the Agent-Memory anti-pattern, §9). The
+  // outer default matches the parsed output shape (Zod v4 requirement).
+  memory: z.object({
+    consolidation: z.object({
+      // Master switch (default false). When false, `consolidate` refuses +
+      // logs (`no-provider`) regardless of provider/model — the first gate.
+      enabled: z.boolean().default(false),
+      // Provider key, e.g. 'anthropic' | 'openai' | 'ollama'. Free-form
+      // string so openai-compatible providers stay expressible without an
+      // enum churn; required (alongside enabled) for consolidation to run.
+      provider: z.string().optional(),
+      // Provider-specific model id (consumed by S8 complete(); optional
+      // here only because a future anonymous local provider may not need it
+      // — runConsolidation still refuses when model is absent).
+      model: z.string().optional(),
+      // Restrict candidates to these types (default: every non-`lesson`).
+      types: z.array(z.string()).optional()
+    }).default({ enabled: false })
+  }).default({ consolidation: { enabled: false } })
+});
+function parseConfig(raw) {
+  return NoirConfigSchema.parse(raw);
+}
+
+// src/layout.ts
+import { homedir } from "os";
+import { join } from "path";
+var NOIR_DIR = ".noir";
+function noirHome() {
+  return join(homedir(), NOIR_DIR);
+}
+function modelsDir() {
+  return join(noirHome(), "models");
+}
+var paths = {
+  noirDir: (root) => join(root, NOIR_DIR),
+  noirMd: (root) => join(root, NOIR_DIR, "NOIR.md"),
+  config: (root) => join(root, NOIR_DIR, "config.yml"),
+  projectId: (root) => join(root, NOIR_DIR, "project.id"),
+  storeDir: (root) => join(root, NOIR_DIR, "store"),
+  storeDb: (root, projectId) => join(root, NOIR_DIR, "store", `${projectId}.db`),
+  // Artifact directories and files
+  specsDir: (root) => join(root, NOIR_DIR, "specs"),
+  specFile: (root, taskId, slug) => join(root, NOIR_DIR, "specs", `${taskId}-${slug}.md`),
+  plansDir: (root) => join(root, NOIR_DIR, "plans"),
+  planFile: (root, taskId, slug) => join(root, NOIR_DIR, "plans", `${taskId}-${slug}.md`),
+  tasksDir: (root) => join(root, NOIR_DIR, "tasks"),
+  taskFile: (root, taskId, taskName) => join(root, NOIR_DIR, "tasks", `${taskId}-${taskName}.md`),
+  decisionsDir: (root) => join(root, NOIR_DIR, "decisions"),
+  decisionFile: (root, n) => join(root, NOIR_DIR, "decisions", `${String(n).padStart(4, "0")}.md`),
+  auditDir: (root) => join(root, NOIR_DIR, "audit"),
+  auditFile: (root, taskId) => join(root, NOIR_DIR, "audit", `${taskId}.json`)
+};
+
+// src/markers.ts
+var CONTEXT_BLOCK_BEGIN = "<!-- noir:context begin -->";
+var CONTEXT_BLOCK_END = "<!-- noir:context end -->";
+
+// src/project.ts
+import { readFileSync } from "fs";
+import { basename } from "path";
+import { parse as parseYaml } from "yaml";
+function loadProjectInfo(root) {
+  let rawId;
+  let rawConfig;
+  try {
+    rawId = readFileSync(paths.projectId(root), "utf8").trim();
+    rawConfig = parseYaml(readFileSync(paths.config(root), "utf8"));
+  } catch {
+    throw new Error(`Noir is not initialized in ${root}. Run \`noir init\` first.`);
+  }
+  const config = parseConfig(rawConfig);
+  return {
+    id: rawId,
+    name: config.name ?? basename(root),
+    root,
+    config
+  };
+}
+
+// src/project-id.ts
+import { randomUUID } from "crypto";
+function createProjectId() {
+  return randomUUID();
+}
+
+// src/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { fileURLToPath } from "url";
+var pkgPath = fileURLToPath(new URL("../package.json", import.meta.url));
+var NOIR_VERSION = JSON.parse(readFileSync2(pkgPath, "utf8")).version ?? "0.0.0";
+export {
+  CONTEXT_BLOCK_BEGIN,
+  CONTEXT_BLOCK_END,
+  NOIR_DIR,
+  NOIR_VERSION,
+  NoirConfigSchema,
+  createProjectId,
+  loadProjectInfo,
+  modelsDir,
+  noirHome,
+  parseConfig,
+  paths
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/layout.ts","../src/markers.ts","../src/project.ts","../src/project-id.ts","../src/version.ts"],"sourcesContent":["import * as z from 'zod';\n\nexport const NoirConfigSchema = z.object({\n  host: z.literal('claude'),\n  name: z.string().optional(),\n  mode: z.enum(['full', 'quick']).default('full'),\n  daemon: z\n    .object({\n      idleTimeoutSec: z.number().int().positive().default(900),\n      port: z.number().int().min(0).max(65535).optional(),\n    })\n    .default({ idleTimeoutSec: 900 }),\n  // Slice S6 context layer (@noir-ai/context). Mirrors the `daemon` idiom — a\n  // top-level object with `.default({})` so a config with NO `context:` block\n  // still parses and behaves as local-embedder-attempted (AC-7 / NFR-6). The\n  // embedder shape is `kind`-based to match the discriminated `EmbedderConfig`\n  // the context factory consumes; `resolveEmbedderConfig` (@noir-ai/context) is\n  // the single bridge from this user-facing schema to the factory input, so core\n  // never imports context (no core→context cycle). Provider-explicit, NEVER\n  // silent remote (blueprint D6): `kind:'remote'`/`'ollama'` are opt-in only;\n  // the default `'local'` is in-process, offline, free, private.\n  context: z\n    .object({\n      embedder: z\n        .object({\n          kind: z.enum(['local', 'remote', 'ollama', 'none']).default('local'),\n          // HF repo id (local) / provider model id (remote) / Ollama tag.\n          model: z.string().optional(),\n          // Remote provider key, e.g. 'openai' (only meaningful when kind:'remote').\n          // Free-form string so openai-compatible providers stay expressible; the\n          // resolver maps known names (openai/voyage/cohere) to their API-key env var.\n          provider: z.string().optional(),\n          // Ollama base URL, e.g. http://localhost:11434 (only when kind:'ollama').\n          baseURL: z.string().optional(),\n          // Target dimensionality — must be 384 to match the existing vec0 table.\n          dim: z.number().int().positive().default(384),\n        })\n        .default({ kind: 'local', dim: 384 }),\n      // Configured index roots (informational in core; the daemon/indexer consume).\n      roots: z.array(z.string()).default([]),\n      // Default token budget for a `context_search` result set (retriever default).\n      budgetTokens: z.number().int().positive().default(4096),\n    })\n    // Zod v4 requires the outer default to match the parsed output shape (every\n    // inner field already carries its own default, so an absent `context:` block\n    // still resolves to local-embedder/empty-roots/4096). Mirrors `daemon:`.\n    .default({ embedder: { kind: 'local', dim: 384 }, roots: [], budgetTokens: 4096 }),\n  // Slice S8 bounded model layer (@noir-ai/model). Mirrors the `daemon` idiom —\n  // a top-level object with `.default({})` so a config with NO `model:` block\n  // still parses and behaves as fully-degraded (every `complete()` call returns\n  // `null`; callers substitute a template — the always-available offline path,\n  // blueprint D5 / DS-5). `resolveModelConfig` (@noir-ai/model) is the single\n  // bridge from this user-facing schema to the runtime shape `complete()`\n  // consumes, so core never imports model (no core→model cycle).\n  //\n  // Provider-EXPLICIT, never silent paid (blueprint D5 / DS-6): the provider is\n  // resolved ONLY from explicit `defaultProvider` / a tier's provider key. Env-\n  // var presence is NEVER consulted to pick a provider — `ANTHROPIC_API_KEY`\n  // being set for another tool does NOT activate Anthropic in Noir. No explicit,\n  // configured provider ⇒ `null`. Secrets live in env vars only (DS-8):\n  // `apiKeyEnv` stores the env-var NAME (`ANTHROPIC_API_KEY`), never the value,\n  // so `.noir/config.yml` stays safe to commit and share; `complete()` reads the\n  // value at call time. `tiers` map a tier name → provider block key; each\n  // `providers[name]` declares the model id, optional `baseURL` (openai-compat),\n  // and optional `apiKeyEnv` (omit for anonymous local providers like Ollama).\n  model: z\n    .object({\n      // Fallback provider name (key into `providers`) when a call's tier resolves\n      // no explicit provider. Free-form string so openai-compatible providers stay\n      // expressible without an enum churn.\n      defaultProvider: z.string().optional(),\n      // Per-tier provider-key overrides (draft / title / summarize / consolidate).\n      // Each value is a key into `providers{}`; resolution is the consumer's job\n      // (tier → tier.provider → defaultProvider → providers[name]).\n      tiers: z\n        .object({\n          draft: z.string().optional(),\n          title: z.string().optional(),\n          summarize: z.string().optional(),\n          consolidate: z.string().optional(),\n        })\n        .optional(),\n      // Configured provider blocks, keyed by name. `model` is required (a provider\n      // without a model id is meaningless); `apiKeyEnv` is omitted for anonymous\n      // local providers (Ollama / LM Studio) which then send no auth header.\n      providers: z\n        .record(\n          z.string(),\n          z.object({\n            model: z.string(),\n            baseURL: z.string().optional(),\n            apiKeyEnv: z.string().optional(),\n          }),\n        )\n        .optional(),\n    })\n    // Absent `model:` block ⇒ `{}` ⇒ every tier/provider is undefined ⇒ full\n    // degradation (offline, free, the default). Inner fields are `.optional()`\n    // (no inner `.default()`) so a present-but-empty block also degrades.\n    .default({}),\n  // Slice S7 cross-session memory (@noir-ai/memory). Mirrors the `daemon` idiom —\n  // a top-level object with `.default({})` so a config with NO `memory:` block\n  // still parses and behaves as consolidation-disabled (the safe default —\n  // capture/store/retrieve are always local + free; consolidation is the ONLY\n  // LLM touch and it is opt-in + provider-explicit). `resolveMemoryConfig`\n  // (@noir-ai/memory) is the single bridge from this user-facing schema to the\n  // runtime `MemoryConfig` the engine consumes, so core never imports memory\n  // (no core→memory cycle; mirrors @noir-ai/context + @noir-ai/model).\n  //\n  // Provider-EXPLICIT, never silent paid (blueprint D6 / DS-6): the provider is\n  // resolved ONLY from explicit `consolidation.provider`. Env-var presence is\n  // NEVER consulted to pick a provider — `ANTHROPIC_API_KEY` being set for\n  // another tool does NOT activate consolidation. No explicit, enabled provider\n  // ⇒ `runConsolidation` refuses with `'no-provider'` + writes a miss audit, and\n  // NO S8 `complete()` call is made (the Agent-Memory anti-pattern, §9). The\n  // outer default matches the parsed output shape (Zod v4 requirement).\n  memory: z\n    .object({\n      consolidation: z\n        .object({\n          // Master switch (default false). When false, `consolidate` refuses +\n          // logs (`no-provider`) regardless of provider/model — the first gate.\n          enabled: z.boolean().default(false),\n          // Provider key, e.g. 'anthropic' | 'openai' | 'ollama'. Free-form\n          // string so openai-compatible providers stay expressible without an\n          // enum churn; required (alongside enabled) for consolidation to run.\n          provider: z.string().optional(),\n          // Provider-specific model id (consumed by S8 complete(); optional\n          // here only because a future anonymous local provider may not need it\n          // — runConsolidation still refuses when model is absent).\n          model: z.string().optional(),\n          // Restrict candidates to these types (default: every non-`lesson`).\n          types: z.array(z.string()).optional(),\n        })\n        // Absent consolidation block ⇒ disabled. Outer shape matches output.\n        .default({ enabled: false }),\n    })\n    .default({ consolidation: { enabled: false } }),\n});\n\nexport type NoirConfig = z.infer<typeof NoirConfigSchema>;\n\nexport function parseConfig(raw: unknown): NoirConfig {\n  return NoirConfigSchema.parse(raw);\n}\n","import { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nexport const NOIR_DIR = '.noir';\n\n/**\n * User-global Noir home: `~/.noir` (HOME-relative, NOT project `.noir/`).\n *\n * Hosts cross-project, user-scoped state — today the daemon record\n * (`~/.noir/daemon.json`, written by @noir-ai/daemon) and the embedding-model\n * cache ({@link modelsDir}). Kept HOME-relative so a single project checkout\n * stays portable across machines (blueprint: `ProjectId` is canonical, never a\n * filesystem path; the project `.noir/` dir never holds machine-local caches).\n */\nexport function noirHome(): string {\n  return join(homedir(), NOIR_DIR);\n}\n\n/**\n * User-global cache for downloaded embedding-model weights: `~/.noir/models/`.\n *\n * Used by @noir-ai/context's local embedder (`@huggingface/transformers` pins\n * `env.cacheDir` here on first load). HOME-relative per spec OQ-7 (resolved) —\n * the ~22 MB MiniLM download is user-scoped, not per-project, so projects stay\n * portable and the weight is fetched at most once per machine.\n */\nexport function modelsDir(): string {\n  return join(noirHome(), 'models');\n}\n\nexport const paths = {\n  noirDir: (root: string) => join(root, NOIR_DIR),\n  noirMd: (root: string) => join(root, NOIR_DIR, 'NOIR.md'),\n  config: (root: string) => join(root, NOIR_DIR, 'config.yml'),\n  projectId: (root: string) => join(root, NOIR_DIR, 'project.id'),\n  storeDir: (root: string) => join(root, NOIR_DIR, 'store'),\n  storeDb: (root: string, projectId: string) => join(root, NOIR_DIR, 'store', `${projectId}.db`),\n  // Artifact directories and files\n  specsDir: (root: string) => join(root, NOIR_DIR, 'specs'),\n  specFile: (root: string, taskId: string, slug: string) =>\n    join(root, NOIR_DIR, 'specs', `${taskId}-${slug}.md`),\n  plansDir: (root: string) => join(root, NOIR_DIR, 'plans'),\n  planFile: (root: string, taskId: string, slug: string) =>\n    join(root, NOIR_DIR, 'plans', `${taskId}-${slug}.md`),\n  tasksDir: (root: string) => join(root, NOIR_DIR, 'tasks'),\n  taskFile: (root: string, taskId: string, taskName: string) =>\n    join(root, NOIR_DIR, 'tasks', `${taskId}-${taskName}.md`),\n  decisionsDir: (root: string) => join(root, NOIR_DIR, 'decisions'),\n  decisionFile: (root: string, n: number) =>\n    join(root, NOIR_DIR, 'decisions', `${String(n).padStart(4, '0')}.md`),\n  auditDir: (root: string) => join(root, NOIR_DIR, 'audit'),\n  auditFile: (root: string, taskId: string) => join(root, NOIR_DIR, 'audit', `${taskId}.json`),\n} as const;\n","export const CONTEXT_BLOCK_BEGIN = '<!-- noir:context begin -->';\nexport const CONTEXT_BLOCK_END = '<!-- noir:context end -->';\n","import { readFileSync } from 'node:fs';\nimport { basename } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport { type NoirConfig, parseConfig } from './config.js';\nimport { paths } from './layout.js';\nimport type { ProjectId } from './project-id.js';\n\nexport interface ProjectInfo {\n  id: ProjectId;\n  name: string;\n  root: string;\n  config: NoirConfig;\n}\n\nexport function loadProjectInfo(root: string): ProjectInfo {\n  let rawId: string;\n  let rawConfig: unknown;\n  try {\n    rawId = readFileSync(paths.projectId(root), 'utf8').trim();\n    rawConfig = parseYaml(readFileSync(paths.config(root), 'utf8'));\n  } catch {\n    throw new Error(`Noir is not initialized in ${root}. Run \\`noir init\\` first.`);\n  }\n  const config = parseConfig(rawConfig);\n  return {\n    id: rawId,\n    name: config.name ?? basename(root),\n    root,\n    config,\n  };\n}\n","import { randomUUID } from 'node:crypto';\n\n/** Canonical, machine-stable project identity. NEVER a filesystem path. */\nexport type ProjectId = string;\n\nexport function createProjectId(): ProjectId {\n  return randomUUID();\n}\n","import { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\n\n// Read the version from THIS package's package.json at module load (NOT a hardcoded\n// constant) so a release bump (scripts/bump-version.mjs) is reflected everywhere\n// `noir` self-identifies — `noir --version`, `noir doctor`/`status`, the MCP\n// initialize handshake — with zero drift between package.json and the binary.\n//\n// `import.meta.url` resolves correctly in every layout the package ships in:\n//   src (vitest):  packages/core/src/version.ts        → ../package.json = packages/core/package.json\n//   dist (tsup):   packages/core/dist/index.js         → ../package.json = packages/core/package.json\n//   published:     node_modules/@noir-ai/core/dist/... → ../package.json = @noir-ai/core/package.json\n// (npm ALWAYS ships package.json alongside dist/, so the read is safe in the tarball.)\nconst pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));\nexport const NOIR_VERSION: string =\n  (JSON.parse(readFileSync(pkgPath, 'utf8')) as { version?: string }).version ?? '0.0.0';\n"],"mappings":"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","names":["readFileSync"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@noir-ai/core",
+  "version": "1.0.0-beta.1",
+  "description": "Noir core — shared types, the config schema (NoirConfigSchema), the .noir/ layout, and markers.",
+  "license": "MIT",
+  "author": "agaaaptr",
+  "homepage": "https://github.com/agaaaptr/noir#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agaaaptr/noir.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/agaaaptr/noir/issues"
+  },
+  "keywords": [
+    "noir",
+    "agent",
+    "sdd",
+    "spec-driven",
+    "config",
+    "domain",
+    "toolkit"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "yaml": "^2.5.0",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}