Method vault_intent_create

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

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, derived from the project dir.
            if manifest.intent_prefix.is_empty() {
                let project_name = self
                    .root
                    .file_name()
                    .and_then(|n| n.to_str())
                    .unwrap_or("vault");
                manifest.intent_prefix = VaultManifest::derive_intent_prefix(project_name);
                if manifest.intent_prefix.is_empty() {
                    manifest.intent_prefix = "VAULT".to_string();
                }
            }

            project = manifest.project_code().to_string();
            seq = manifest.allocate_author_seq(&author);
            human_key = VaultManifest::compose_human_key(&project, &author, seq);