Method vault_intent_create

atomic-repository/src/repository/vault_intent.rs:116–337

Create a new vault intent. Allocates a JIRA-style ID (e.g., "PIMO-1") and creates an intent directory with an `intent.md` scaffold. The prefix is derived from the project directory name on first use (first 4 alphanumeric chars, uppercased). Intent paths are view-scoped and session-scoped: `intents/ / / /intent.md`

(
        &self,
        options: IntentCreateOptions,
    )

    /// Intent paths are view-scoped and session-scoped:
    /// `intents/<view>/<session>/<turn>/intent.md`
    pub fn vault_intent_create(
        &self,
        options: IntentCreateOptions,
    ) -> Result<IntentCreateResult, RepositoryError> {
        if !self.has_vault()? {
            return Err(RepositoryError::InvalidOperation {
                message: "Vault not initialized. Run `atomic vault init` first.".to_string(),
            });
        }

        let priority = options.priority.unwrap_or_else(|| "medium".to_string());
        // Classification, defaulting to `feature`. Stored on the summary always;
        // written to frontmatter only when non-default (so ordinary intents keep
        // no `kind` key and their canonical hashes are unchanged).
        let kind = options
            .kind
            .clone()
            .unwrap_or_else(|| "feature".to_string());
        let view_name = self.current_view().to_string();
        let identity = self.resolve_vault_identity();
        let author = slug_author(&identity.name);

        // Stable primary identity: a ULID. The path, URN, and KG node all key
        // off this, so it never collides regardless of team size or offline
        // work. The human key is a per-author display alias.
        let uid = ulid::Ulid::new().to_string();
        let intent_dir = self.intent_dir_for(&uid);
        let intent_file = self.intent_file_for(&uid);

        // Allocate the human key inside a write transaction.
        let human_key;
        let project;
        let seq;
        {
            let mut txn = self
                .pristine
                .write_txn()
                .map_err(|e| RepositoryError::Database(e.to_string()))?;
            let mut manifest = txn
                .get_vault_manifest()
                .map_err(|e| RepositoryError::Database(e.to_string()))?;

            // Set the project code on first use.
            //
            // `ATOMIC_PROJECT_CODE` wins when set, because the directory name
            // is not always the project's name: an agent sandbox roots the
            // repository at the sandbox directory, so the first intent created
            // inside one stamped every intent in that project `SAND::…`
            // forever (the prefix is set once and kept). Callers that know the
            // real project — an orchestrator working from a project slug — set
            // the variable and get a stable, meaningful code.
            if manifest.intent_prefix.is_empty() {
                let from_env = std::env::var("ATOMIC_PROJECT_CODE")
                    .ok()
                    .map(|v| v.trim().to_string())
                    .filter(|v| !v.is_empty());
                let project_name = match from_env {
                    Some(code) => code,