@hasna/instructions 0.4.27 → 0.4.29

package/README.md

@@ -293,6 +293,12 @@ compatible last-known-good cache can be selected explicitly with
 `--allow-stale-cache --expected-project-id <id>`; its bounded age/status is
 visible in the rendered context.
 
+Projects v2 bundles may carry the strict optional
+`hasna.projects.finance_project_metadata.v1` object. Instructions validates
+that object and preserves every accepted finance field through the bundle
+cache and session-manifest provenance path; malformed finance metadata and
+finance attached to a legacy v1 bundle fail closed.
+
 Compatibility remains additive: project-context manifests keep
 `hasna.configs.session-render/v1`, `Managed by @hasna/configs`, and
 `ownedBy: open-configs`, while recording `canonicalOwner: instructions`. The

package/dist/cli/index.js

@@ -7959,7 +7959,7 @@ function parseProjectContextBundleInternal(input, allowLegacyHash, normalizeLega
   }
   const result = projectContextBundleSchema.safeParse(value);
   if (!result.success) {
-    throw new ProjectContextError("PROJECT_CONTEXT_INVALID", "bundle does not match the strict v1 schema", {
+    throw new ProjectContextError("PROJECT_CONTEXT_INVALID", "bundle does not match a strict supported schema", {
       issues: result.error.issues.map((issue) => ({ path: issue.path.join("."), code: issue.code, message: issue.message }))
     });
   }
@@ -7969,7 +7969,7 @@ function parseProjectContextBundleInternal(input, allowLegacyHash, normalizeLega
   validateIdentityConsistency(bundle);
   rejectCredentialLikeBundle(bundle);
   const expected = computeProjectContextSourceHash(bundle);
-  const matchesLegacyHash = bundle.hash !== expected && allowLegacyHash && bundle.hash === computeLegacyProjectContextSourceHash(bundle);
+  const matchesLegacyHash = bundle.hash !== expected && allowLegacyHash && bundle.schema === PROJECT_CONTEXT_SCHEMA && bundle.hash === computeLegacyProjectContextSourceHash(bundle);
   if (bundle.hash !== expected && !matchesLegacyHash) {
     throw new ProjectContextError("PROJECT_CONTEXT_HASH_MISMATCH", "bundle hash does not match its canonical allowlisted payload");
   }
@@ -8572,10 +8572,24 @@ function findLegacyCodewithWorkspaceSection(workspaceRoot, runtime, content, bun
   }
   return { start: section.index, end };
 }
+function isCanonicalV1ToV2RevisionUpgrade(incoming, cache) {
+  if (cache === null || cache.bundle.schema !== PROJECT_CONTEXT_SCHEMA || incoming.schema !== PROJECT_CONTEXT_SCHEMA_V2 || cache.project_id !== incoming.project.id || cache.bundle.project.id !== incoming.project.id || cache.revision !== incoming.revision) {
+    return false;
+  }
+  const { finance: _finance, ...incomingSharedProject } = incoming.project;
+  const projectedV1 = {
+    ...incoming,
+    schema: PROJECT_CONTEXT_SCHEMA,
+    project: incomingSharedProject,
+    hash: ""
+  };
+  return computeProjectContextSourceHash(projectedV1) === computeProjectContextSourceHash(cache.bundle);
+}
 function assertRevisionOrdering(plan, force) {
   const observations = [];
   const cache = readProjectContextCache(plan.cache_path, plan.workspace_root);
   const canonicalCacheHash = cache === null ? null : computeProjectContextSourceHash(cache.bundle);
+  const canonicalV1ToV2Upgrade = isCanonicalV1ToV2RevisionUpgrade(plan.bundle, cache);
   const normalizePersistedHash = (revision, hash) => cache !== null && canonicalCacheHash !== null && revision === cache.revision && hash === cache.hash ? canonicalCacheHash : hash;
   const manifest = readProjectContextManifest(plan.manifest_path, plan.workspace_root);
   if (manifest) {
@@ -8613,7 +8627,8 @@ function assertRevisionOrdering(plan, force) {
     if (ordering < 0) {
       throw new ProjectContextError("PROJECT_CONTEXT_REVISION_STALE", `incoming revision ${plan.bundle.revision} is older than ${observation.source} revision ${observation.revision}`);
     }
-    if (ordering === 0 && plan.bundle.hash !== observation.hash) {
+    const isProvenV1Observation = canonicalV1ToV2Upgrade && observation.hash === canonicalCacheHash;
+    if (ordering === 0 && plan.bundle.hash !== observation.hash && !isProvenV1Observation) {
       throw new ProjectContextError("PROJECT_CONTEXT_REVISION_CONFLICT", `revision ${plan.bundle.revision} has a different hash than ${observation.source}`);
     }
   }
@@ -10437,7 +10452,7 @@ function sha2562(content) {
 function isRecord(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
-var PROJECT_CONTEXT_SCHEMA = "hasna.projects.project_context_bundle.v1", PROJECT_CONTEXT_SCHEMA_V2 = "hasna.projects.project_context_bundle.v2", PROJECT_CONTEXT_SUPPORTED_SCHEMAS, projectContextSchema, PROJECT_CONTEXT_MAX_INPUT_BYTES, PROJECT_CONTEXT_MAX_RENDERED_BYTES, PROJECT_CONTEXT_MAX_APPROX_TOKENS = 1000, PROJECT_CONTEXT_MAX_COMMANDS = 6, PROJECT_CONTEXT_MAX_WARNINGS = 3, PROJECT_CONTEXT_FRAGMENT_PATH = ".hasna/instructions/project-context.md", PROJECT_CONTEXT_MANIFEST_PATH = ".hasna/project-context-manifest.json", PROJECT_CONTEXT_CACHE_PATH = ".hasna/project-context-cache.json", PROJECT_CONTEXT_LOCK_PATH = ".hasna/project-context.lock", PROJECT_CONTEXT_SNAPSHOT_DIR = ".hasna/project-context-snapshots", PROJECT_CONTEXT_CACHE_SCHEMA = "hasna.instructions.project-context-cache/v1", PROJECT_CONTEXT_MANAGED_COMMENT = "Managed by @hasna/configs project context", SESSION_COMPATIBILITY_MANIFEST_MAX_BYTES, FOREIGN_INPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_MAX_BYTES, SESSION_MANAGED_INPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_PATHS, SESSION_MANAGED_OUTPUT_WARN_BYTES, PROJECT_CONTEXT_LOCK_STALE_MS, LEGACY_CONFIGS_PACKAGE = "@hasna/configs", LEGACY_CONFIGS_COMPAT_VERSION = "0.2.45", LEGACY_CONFIGS_EXECUTABLE = "configs", PROJECT_KINDS, PROJECT_STATUSES, LINK_STATES, RESOLUTION_SOURCES, safeId, nullableId, producerSlug, producerName, safeOptionalDisplay, isoTimestamp, revisionSchema, hashSchema, absolutePath, commandArg, commandSchema, projectContextBundleSchema, storedManifestProjectContextSchema, storedManifestFileSchema, storedManifestObservationSchema, projectContextMetadataSnapshotSchema, projectContextCacheSchema, ProjectContextError, ProjectContextHashRace, anchoredFsOps, atomicExchange, atomicExchangeLibraries;
+var PROJECT_CONTEXT_SCHEMA = "hasna.projects.project_context_bundle.v1", PROJECT_CONTEXT_SCHEMA_V2 = "hasna.projects.project_context_bundle.v2", PROJECT_CONTEXT_SUPPORTED_SCHEMAS, projectContextSchema, PROJECT_CONTEXT_MAX_INPUT_BYTES, PROJECT_CONTEXT_MAX_RENDERED_BYTES, PROJECT_CONTEXT_MAX_APPROX_TOKENS = 1000, PROJECT_CONTEXT_MAX_COMMANDS = 6, PROJECT_CONTEXT_MAX_WARNINGS = 3, PROJECT_CONTEXT_FRAGMENT_PATH = ".hasna/instructions/project-context.md", PROJECT_CONTEXT_MANIFEST_PATH = ".hasna/project-context-manifest.json", PROJECT_CONTEXT_CACHE_PATH = ".hasna/project-context-cache.json", PROJECT_CONTEXT_LOCK_PATH = ".hasna/project-context.lock", PROJECT_CONTEXT_SNAPSHOT_DIR = ".hasna/project-context-snapshots", PROJECT_CONTEXT_CACHE_SCHEMA = "hasna.instructions.project-context-cache/v1", PROJECT_CONTEXT_MANAGED_COMMENT = "Managed by @hasna/configs project context", SESSION_COMPATIBILITY_MANIFEST_MAX_BYTES, FOREIGN_INPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_MAX_BYTES, SESSION_MANAGED_INPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_PATHS, SESSION_MANAGED_OUTPUT_WARN_BYTES, PROJECT_CONTEXT_LOCK_STALE_MS, LEGACY_CONFIGS_PACKAGE = "@hasna/configs", LEGACY_CONFIGS_COMPAT_VERSION = "0.2.45", LEGACY_CONFIGS_EXECUTABLE = "configs", PROJECT_KINDS, PROJECT_STATUSES, LINK_STATES, RESOLUTION_SOURCES, safeId, nullableId, producerSlug, producerName, safeOptionalDisplay, isoTimestamp, revisionSchema, hashSchema, absolutePath, commandArg, financeText, financeLegalEntity, financeProjectMetadataSchema, commandSchema, projectContextBundleSchema, storedManifestProjectContextSchema, storedManifestFileSchema, storedManifestObservationSchema, projectContextMetadataSnapshotSchema, projectContextCacheSchema, ProjectContextError, ProjectContextHashRace, anchoredFsOps, atomicExchange, atomicExchangeLibraries;
 var init_project_context = __esm(() => {
   init_zod();
   init_redact();
@@ -10486,6 +10501,28 @@ var init_project_context = __esm(() => {
   hashSchema = exports_external.string().regex(/^sha256:[a-f0-9]{64}$/);
   absolutePath = exports_external.string().min(1).max(4096).refine((value) => isAbsolute(value), "must be absolute").refine(isSafeSingleLine, "must be safe").nullable();
   commandArg = exports_external.string().min(1).max(1024).refine((value) => isSafeCommandArgument(value), "unsafe argv item");
+  financeText = exports_external.string().min(1).max(512).refine((value) => value === value.trim(), "must be normalized");
+  financeLegalEntity = exports_external.string().min(1).max(256).refine((value) => value === value.trim(), "must be normalized");
+  financeProjectMetadataSchema = exports_external.object({
+    schema: exports_external.literal("hasna.projects.finance_project_metadata.v1"),
+    business_area: exports_external.literal("finance"),
+    jurisdiction: exports_external.string().min(2).max(64).regex(/^[A-Z0-9][A-Z0-9._:-]{1,63}$/),
+    legal_entities: exports_external.array(financeLegalEntity).min(1).max(100).refine((values) => new Set(values).size === values.length, "must not contain duplicate legal entities"),
+    fiscal_cycle: exports_external.enum(["monthly", "quarterly", "annual", "event-driven"]),
+    data_classification: exports_external.enum(["public", "internal", "confidential", "restricted"]),
+    retention_policy: financeText,
+    ledger_authority: financeText,
+    evidence_store: financeText,
+    approver: financeText,
+    external_recipient_policy: financeText
+  }).strict().superRefine((value, context) => {
+    if (Buffer.byteLength(JSON.stringify(value), "utf8") > 4 * 1024) {
+      context.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: "finance project metadata exceeds the 4 KiB producer context budget"
+      });
+    }
+  });
   commandSchema = exports_external.object({
     name: exports_external.enum(["show", "context", "why", "context-bundle"]),
     argv: exports_external.array(commandArg).min(1).max(8)
@@ -10514,7 +10551,8 @@ var init_project_context = __esm(() => {
       kind: exports_external.enum(PROJECT_KINDS),
       status: exports_external.enum(PROJECT_STATUSES),
       path: absolutePath,
-      updated_at: isoTimestamp
+      updated_at: isoTimestamp,
+      finance: financeProjectMetadataSchema.optional()
     }).strict(),
     links: exports_external.object({
       todos: exports_external.object({
@@ -10537,7 +10575,15 @@ var init_project_context = __esm(() => {
       machine_id: nullableId
     }).strict().nullable(),
     commands: exports_external.array(commandSchema).max(PROJECT_CONTEXT_MAX_COMMANDS)
-  }).strict();
+  }).strict().superRefine((bundle, context) => {
+    if (bundle.schema === PROJECT_CONTEXT_SCHEMA && bundle.project.finance !== undefined) {
+      context.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        path: ["project", "finance"],
+        message: "finance project metadata requires project-context bundle v2"
+      });
+    }
+  });
   storedManifestProjectContextSchema = exports_external.object({
     schema: projectContextSchema,
     projectId: safeId,

package/dist/index.js

@@ -5882,6 +5882,28 @@ var revisionSchema = exports_external.string().min(1).max(512).refine((value) =>
 var hashSchema = exports_external.string().regex(/^sha256:[a-f0-9]{64}$/);
 var absolutePath = exports_external.string().min(1).max(4096).refine((value) => isAbsolute(value), "must be absolute").refine(isSafeSingleLine, "must be safe").nullable();
 var commandArg = exports_external.string().min(1).max(1024).refine((value) => isSafeCommandArgument(value), "unsafe argv item");
+var financeText = exports_external.string().min(1).max(512).refine((value) => value === value.trim(), "must be normalized");
+var financeLegalEntity = exports_external.string().min(1).max(256).refine((value) => value === value.trim(), "must be normalized");
+var financeProjectMetadataSchema = exports_external.object({
+  schema: exports_external.literal("hasna.projects.finance_project_metadata.v1"),
+  business_area: exports_external.literal("finance"),
+  jurisdiction: exports_external.string().min(2).max(64).regex(/^[A-Z0-9][A-Z0-9._:-]{1,63}$/),
+  legal_entities: exports_external.array(financeLegalEntity).min(1).max(100).refine((values) => new Set(values).size === values.length, "must not contain duplicate legal entities"),
+  fiscal_cycle: exports_external.enum(["monthly", "quarterly", "annual", "event-driven"]),
+  data_classification: exports_external.enum(["public", "internal", "confidential", "restricted"]),
+  retention_policy: financeText,
+  ledger_authority: financeText,
+  evidence_store: financeText,
+  approver: financeText,
+  external_recipient_policy: financeText
+}).strict().superRefine((value, context) => {
+  if (Buffer.byteLength(JSON.stringify(value), "utf8") > 4 * 1024) {
+    context.addIssue({
+      code: exports_external.ZodIssueCode.custom,
+      message: "finance project metadata exceeds the 4 KiB producer context budget"
+    });
+  }
+});
 var commandSchema = exports_external.object({
   name: exports_external.enum(["show", "context", "why", "context-bundle"]),
   argv: exports_external.array(commandArg).min(1).max(8)
@@ -5910,7 +5932,8 @@ var projectContextBundleSchema = exports_external.object({
     kind: exports_external.enum(PROJECT_KINDS),
     status: exports_external.enum(PROJECT_STATUSES),
     path: absolutePath,
-    updated_at: isoTimestamp
+    updated_at: isoTimestamp,
+    finance: financeProjectMetadataSchema.optional()
   }).strict(),
   links: exports_external.object({
     todos: exports_external.object({
@@ -5933,7 +5956,15 @@ var projectContextBundleSchema = exports_external.object({
     machine_id: nullableId
   }).strict().nullable(),
   commands: exports_external.array(commandSchema).max(PROJECT_CONTEXT_MAX_COMMANDS)
-}).strict();
+}).strict().superRefine((bundle, context) => {
+  if (bundle.schema === PROJECT_CONTEXT_SCHEMA && bundle.project.finance !== undefined) {
+    context.addIssue({
+      code: exports_external.ZodIssueCode.custom,
+      path: ["project", "finance"],
+      message: "finance project metadata requires project-context bundle v2"
+    });
+  }
+});
 var storedManifestProjectContextSchema = exports_external.object({
   schema: projectContextSchema,
   projectId: safeId,
@@ -6050,7 +6081,7 @@ function parseProjectContextBundleInternal(input, allowLegacyHash, normalizeLega
   }
   const result = projectContextBundleSchema.safeParse(value);
   if (!result.success) {
-    throw new ProjectContextError("PROJECT_CONTEXT_INVALID", "bundle does not match the strict v1 schema", {
+    throw new ProjectContextError("PROJECT_CONTEXT_INVALID", "bundle does not match a strict supported schema", {
       issues: result.error.issues.map((issue) => ({ path: issue.path.join("."), code: issue.code, message: issue.message }))
     });
   }
@@ -6060,7 +6091,7 @@ function parseProjectContextBundleInternal(input, allowLegacyHash, normalizeLega
   validateIdentityConsistency(bundle);
   rejectCredentialLikeBundle(bundle);
   const expected = computeProjectContextSourceHash(bundle);
-  const matchesLegacyHash = bundle.hash !== expected && allowLegacyHash && bundle.hash === computeLegacyProjectContextSourceHash(bundle);
+  const matchesLegacyHash = bundle.hash !== expected && allowLegacyHash && bundle.schema === PROJECT_CONTEXT_SCHEMA && bundle.hash === computeLegacyProjectContextSourceHash(bundle);
   if (bundle.hash !== expected && !matchesLegacyHash) {
     throw new ProjectContextError("PROJECT_CONTEXT_HASH_MISMATCH", "bundle hash does not match its canonical allowlisted payload");
   }
@@ -6663,10 +6694,24 @@ function findLegacyCodewithWorkspaceSection(workspaceRoot, runtime, content, bun
   }
   return { start: section.index, end };
 }
+function isCanonicalV1ToV2RevisionUpgrade(incoming, cache) {
+  if (cache === null || cache.bundle.schema !== PROJECT_CONTEXT_SCHEMA || incoming.schema !== PROJECT_CONTEXT_SCHEMA_V2 || cache.project_id !== incoming.project.id || cache.bundle.project.id !== incoming.project.id || cache.revision !== incoming.revision) {
+    return false;
+  }
+  const { finance: _finance, ...incomingSharedProject } = incoming.project;
+  const projectedV1 = {
+    ...incoming,
+    schema: PROJECT_CONTEXT_SCHEMA,
+    project: incomingSharedProject,
+    hash: ""
+  };
+  return computeProjectContextSourceHash(projectedV1) === computeProjectContextSourceHash(cache.bundle);
+}
 function assertRevisionOrdering(plan, force) {
   const observations = [];
   const cache = readProjectContextCache(plan.cache_path, plan.workspace_root);
   const canonicalCacheHash = cache === null ? null : computeProjectContextSourceHash(cache.bundle);
+  const canonicalV1ToV2Upgrade = isCanonicalV1ToV2RevisionUpgrade(plan.bundle, cache);
   const normalizePersistedHash = (revision, hash) => cache !== null && canonicalCacheHash !== null && revision === cache.revision && hash === cache.hash ? canonicalCacheHash : hash;
   const manifest = readProjectContextManifest(plan.manifest_path, plan.workspace_root);
   if (manifest) {
@@ -6704,7 +6749,8 @@ function assertRevisionOrdering(plan, force) {
     if (ordering < 0) {
       throw new ProjectContextError("PROJECT_CONTEXT_REVISION_STALE", `incoming revision ${plan.bundle.revision} is older than ${observation.source} revision ${observation.revision}`);
     }
-    if (ordering === 0 && plan.bundle.hash !== observation.hash) {
+    const isProvenV1Observation = canonicalV1ToV2Upgrade && observation.hash === canonicalCacheHash;
+    if (ordering === 0 && plan.bundle.hash !== observation.hash && !isProvenV1Observation) {
       throw new ProjectContextError("PROJECT_CONTEXT_REVISION_CONFLICT", `revision ${plan.bundle.revision} has a different hash than ${observation.source}`);
     }
   }

package/dist/lib/project-context.d.ts

@@ -44,7 +44,7 @@ export declare function isSessionManagedOutputRelativePath(relativePath: string)
 export declare const LEGACY_CONFIGS_PACKAGE: "@hasna/configs";
 export declare const LEGACY_CONFIGS_COMPAT_VERSION: "0.2.45";
 export declare const LEGACY_CONFIGS_EXECUTABLE: "configs";
-declare const projectContextBundleSchema: z.ZodObject<{
+declare const projectContextBundleSchema: z.ZodEffects<z.ZodObject<{
     schema: z.ZodEnum<["hasna.projects.project_context_bundle.v1", "hasna.projects.project_context_bundle.v2"]>;
     generated_at: z.ZodEffects<z.ZodString, string, string>;
     hash: z.ZodString;
@@ -87,6 +87,67 @@ declare const projectContextBundleSchema: z.ZodObject<{
         status: z.ZodEnum<["active", "archived", "deleted"]>;
         path: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
         updated_at: z.ZodEffects<z.ZodString, string, string>;
+        finance: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            schema: z.ZodLiteral<"hasna.projects.finance_project_metadata.v1">;
+            business_area: z.ZodLiteral<"finance">;
+            jurisdiction: z.ZodString;
+            legal_entities: z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">, string[], string[]>;
+            fiscal_cycle: z.ZodEnum<["monthly", "quarterly", "annual", "event-driven"]>;
+            data_classification: z.ZodEnum<["public", "internal", "confidential", "restricted"]>;
+            retention_policy: z.ZodEffects<z.ZodString, string, string>;
+            ledger_authority: z.ZodEffects<z.ZodString, string, string>;
+            evidence_store: z.ZodEffects<z.ZodString, string, string>;
+            approver: z.ZodEffects<z.ZodString, string, string>;
+            external_recipient_policy: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        }, {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        }>, {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        }, {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        }>>;
     }, "strict", z.ZodTypeAny, {
         id: string;
         name: string;
@@ -95,6 +156,19 @@ declare const projectContextBundleSchema: z.ZodObject<{
         updated_at: string;
         status: "active" | "archived" | "deleted";
         path: string | null;
+        finance?: {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        } | undefined;
     }, {
         id: string;
         name: string;
@@ -103,6 +177,19 @@ declare const projectContextBundleSchema: z.ZodObject<{
         updated_at: string;
         status: "active" | "archived" | "deleted";
         path: string | null;
+        finance?: {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        } | undefined;
     }>;
     links: z.ZodObject<{
         todos: z.ZodObject<{
@@ -201,6 +288,145 @@ declare const projectContextBundleSchema: z.ZodObject<{
         updated_at: string;
         status: "active" | "archived" | "deleted";
         path: string | null;
+        finance?: {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        } | undefined;
+    };
+    schema: "hasna.projects.project_context_bundle.v1" | "hasna.projects.project_context_bundle.v2";
+    generated_at: string;
+    hash: string;
+    revision: string;
+    freshness: "unknown" | "fresh" | "stale";
+    resolution: {
+        source: "name" | "path" | "marker" | "id-or-slug";
+        conflict: boolean;
+        create_allowed: boolean;
+    };
+    authority: {
+        mode: "local" | "api";
+        owner: "projects";
+        storage: "sqlite" | "cloud" | "self-hosted";
+        availability: "available" | "unavailable";
+    };
+    links: {
+        todos: {
+            state: "linked" | "partial" | "unlinked";
+            project_id: string | null;
+            task_list_id: string | null;
+        };
+        conversations: {
+            state: "linked" | "partial" | "unlinked";
+            channel: string | null;
+        };
+        mementos: {
+            state: "linked" | "partial" | "unlinked";
+            project_id: string | null;
+            scope: string | null;
+        };
+    };
+    station: {
+        machine_id: string | null;
+        station_id: string | null;
+    } | null;
+    commands: {
+        name: "show" | "context" | "why" | "context-bundle";
+        argv: string[];
+    }[];
+}, {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+        kind: "open-source" | "internal-app" | "platform" | "company-website" | "scaffold" | "community" | "project" | "experiment" | "docs" | "remote-only" | "generic";
+        updated_at: string;
+        status: "active" | "archived" | "deleted";
+        path: string | null;
+        finance?: {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        } | undefined;
+    };
+    schema: "hasna.projects.project_context_bundle.v1" | "hasna.projects.project_context_bundle.v2";
+    generated_at: string;
+    hash: string;
+    revision: string;
+    freshness: "unknown" | "fresh" | "stale";
+    resolution: {
+        source: "name" | "path" | "marker" | "id-or-slug";
+        conflict: boolean;
+        create_allowed: boolean;
+    };
+    authority: {
+        mode: "local" | "api";
+        owner: "projects";
+        storage: "sqlite" | "cloud" | "self-hosted";
+        availability: "available" | "unavailable";
+    };
+    links: {
+        todos: {
+            state: "linked" | "partial" | "unlinked";
+            project_id: string | null;
+            task_list_id: string | null;
+        };
+        conversations: {
+            state: "linked" | "partial" | "unlinked";
+            channel: string | null;
+        };
+        mementos: {
+            state: "linked" | "partial" | "unlinked";
+            project_id: string | null;
+            scope: string | null;
+        };
+    };
+    station: {
+        machine_id: string | null;
+        station_id: string | null;
+    } | null;
+    commands: {
+        name: "show" | "context" | "why" | "context-bundle";
+        argv: string[];
+    }[];
+}>, {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+        kind: "open-source" | "internal-app" | "platform" | "company-website" | "scaffold" | "community" | "project" | "experiment" | "docs" | "remote-only" | "generic";
+        updated_at: string;
+        status: "active" | "archived" | "deleted";
+        path: string | null;
+        finance?: {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        } | undefined;
     };
     schema: "hasna.projects.project_context_bundle.v1" | "hasna.projects.project_context_bundle.v2";
     generated_at: string;
@@ -251,6 +477,19 @@ declare const projectContextBundleSchema: z.ZodObject<{
         updated_at: string;
         status: "active" | "archived" | "deleted";
         path: string | null;
+        finance?: {
+            schema: "hasna.projects.finance_project_metadata.v1";
+            business_area: "finance";
+            jurisdiction: string;
+            legal_entities: string[];
+            fiscal_cycle: "monthly" | "quarterly" | "annual" | "event-driven";
+            data_classification: "public" | "internal" | "confidential" | "restricted";
+            retention_policy: string;
+            ledger_authority: string;
+            evidence_store: string;
+            approver: string;
+            external_recipient_policy: string;
+        } | undefined;
     };
     schema: "hasna.projects.project_context_bundle.v1" | "hasna.projects.project_context_bundle.v2";
     generated_at: string;

package/dist/lib/project-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/lib/project-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/lib/project-context.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.js

@@ -5729,7 +5729,7 @@ function isSafeSingleLine(value) {
 function isSafeCommandArgument(value) {
   return /^[A-Za-z0-9_./:@+=,-]+$/.test(value) && !value.includes("://") && !value.startsWith("-") || /^--[a-z][a-z0-9-]*$/.test(value);
 }
-var PROJECT_CONTEXT_SCHEMA = "hasna.projects.project_context_bundle.v1", PROJECT_CONTEXT_SCHEMA_V2 = "hasna.projects.project_context_bundle.v2", PROJECT_CONTEXT_SUPPORTED_SCHEMAS, projectContextSchema, PROJECT_CONTEXT_MAX_INPUT_BYTES, PROJECT_CONTEXT_MAX_RENDERED_BYTES, PROJECT_CONTEXT_MAX_COMMANDS = 6, PROJECT_CONTEXT_FRAGMENT_PATH = ".hasna/instructions/project-context.md", PROJECT_CONTEXT_CACHE_SCHEMA = "hasna.instructions.project-context-cache/v1", SESSION_COMPATIBILITY_MANIFEST_MAX_BYTES, FOREIGN_INPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_WARN_BYTES, PROJECT_CONTEXT_LOCK_STALE_MS, PROJECT_KINDS, PROJECT_STATUSES, LINK_STATES, RESOLUTION_SOURCES, safeId, nullableId, producerSlug, producerName, safeOptionalDisplay, isoTimestamp, revisionSchema, hashSchema, absolutePath, commandArg, commandSchema, projectContextBundleSchema, storedManifestProjectContextSchema, storedManifestFileSchema, storedManifestObservationSchema, projectContextMetadataSnapshotSchema, projectContextCacheSchema;
+var PROJECT_CONTEXT_SCHEMA = "hasna.projects.project_context_bundle.v1", PROJECT_CONTEXT_SCHEMA_V2 = "hasna.projects.project_context_bundle.v2", PROJECT_CONTEXT_SUPPORTED_SCHEMAS, projectContextSchema, PROJECT_CONTEXT_MAX_INPUT_BYTES, PROJECT_CONTEXT_MAX_RENDERED_BYTES, PROJECT_CONTEXT_MAX_COMMANDS = 6, PROJECT_CONTEXT_FRAGMENT_PATH = ".hasna/instructions/project-context.md", PROJECT_CONTEXT_CACHE_SCHEMA = "hasna.instructions.project-context-cache/v1", SESSION_COMPATIBILITY_MANIFEST_MAX_BYTES, FOREIGN_INPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_MAX_BYTES, SESSION_MANAGED_OUTPUT_WARN_BYTES, PROJECT_CONTEXT_LOCK_STALE_MS, PROJECT_KINDS, PROJECT_STATUSES, LINK_STATES, RESOLUTION_SOURCES, safeId, nullableId, producerSlug, producerName, safeOptionalDisplay, isoTimestamp, revisionSchema, hashSchema, absolutePath, commandArg, financeText, financeLegalEntity, financeProjectMetadataSchema, commandSchema, projectContextBundleSchema, storedManifestProjectContextSchema, storedManifestFileSchema, storedManifestObservationSchema, projectContextMetadataSnapshotSchema, projectContextCacheSchema;
 var init_project_context = __esm(() => {
   init_zod();
   init_redact();
@@ -5769,6 +5769,28 @@ var init_project_context = __esm(() => {
   hashSchema = exports_external.string().regex(/^sha256:[a-f0-9]{64}$/);
   absolutePath = exports_external.string().min(1).max(4096).refine((value) => isAbsolute(value), "must be absolute").refine(isSafeSingleLine, "must be safe").nullable();
   commandArg = exports_external.string().min(1).max(1024).refine((value) => isSafeCommandArgument(value), "unsafe argv item");
+  financeText = exports_external.string().min(1).max(512).refine((value) => value === value.trim(), "must be normalized");
+  financeLegalEntity = exports_external.string().min(1).max(256).refine((value) => value === value.trim(), "must be normalized");
+  financeProjectMetadataSchema = exports_external.object({
+    schema: exports_external.literal("hasna.projects.finance_project_metadata.v1"),
+    business_area: exports_external.literal("finance"),
+    jurisdiction: exports_external.string().min(2).max(64).regex(/^[A-Z0-9][A-Z0-9._:-]{1,63}$/),
+    legal_entities: exports_external.array(financeLegalEntity).min(1).max(100).refine((values) => new Set(values).size === values.length, "must not contain duplicate legal entities"),
+    fiscal_cycle: exports_external.enum(["monthly", "quarterly", "annual", "event-driven"]),
+    data_classification: exports_external.enum(["public", "internal", "confidential", "restricted"]),
+    retention_policy: financeText,
+    ledger_authority: financeText,
+    evidence_store: financeText,
+    approver: financeText,
+    external_recipient_policy: financeText
+  }).strict().superRefine((value, context) => {
+    if (Buffer.byteLength(JSON.stringify(value), "utf8") > 4 * 1024) {
+      context.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: "finance project metadata exceeds the 4 KiB producer context budget"
+      });
+    }
+  });
   commandSchema = exports_external.object({
     name: exports_external.enum(["show", "context", "why", "context-bundle"]),
     argv: exports_external.array(commandArg).min(1).max(8)
@@ -5797,7 +5819,8 @@ var init_project_context = __esm(() => {
       kind: exports_external.enum(PROJECT_KINDS),
       status: exports_external.enum(PROJECT_STATUSES),
       path: absolutePath,
-      updated_at: isoTimestamp
+      updated_at: isoTimestamp,
+      finance: financeProjectMetadataSchema.optional()
     }).strict(),
     links: exports_external.object({
       todos: exports_external.object({
@@ -5820,7 +5843,15 @@ var init_project_context = __esm(() => {
       machine_id: nullableId
     }).strict().nullable(),
     commands: exports_external.array(commandSchema).max(PROJECT_CONTEXT_MAX_COMMANDS)
-  }).strict();
+  }).strict().superRefine((bundle, context) => {
+    if (bundle.schema === PROJECT_CONTEXT_SCHEMA && bundle.project.finance !== undefined) {
+      context.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        path: ["project", "finance"],
+        message: "finance project metadata requires project-context bundle v2"
+      });
+    }
+  });
   storedManifestProjectContextSchema = exports_external.object({
     schema: projectContextSchema,
     projectId: safeId,
@@ -7260,7 +7291,7 @@ var init_sync_dir = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/instructions",
-    version: "0.4.27",
+    version: "0.4.29",
     description: "AI coding agent instruction & configuration manager \u2014 store, version, apply, and share all your AI coding configs. CLI + MCP + HTTP API (instructions-serve) + generated SDK + Dashboard.",
     type: "module",
     main: "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/instructions",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "description": "AI coding agent instruction & configuration manager \u2014 store, version, apply, and share all your AI coding configs. CLI + MCP + HTTP API (instructions-serve) + generated SDK + Dashboard.",
   "type": "module",
   "main": "dist/index.js",